---
title: Internal objects
description: You can manage the following internal objects over REST:
component: pingidm
version: 8.1
page_id: pingidm:rest-api-reference:endpoints/rest-internal
canonical_url: https://docs.pingidentity.com/pingidm/8.1/rest-api-reference/endpoints/rest-internal.html
keywords: ["REST API", "internal users"]
---

# Internal objects

You can manage the following internal objects over REST:

| URI                                                     | HTTP Operation | Description                                                                     |
| ------------------------------------------------------- | -------------- | ------------------------------------------------------------------------------- |
| /openidm/internal/role?\_queryFilter=true               | GET            | Lists all internal roles.                                                       |
| /openidm/internal/user?\_queryFilter=true               | GET            | Lists internal users.                                                           |
| /openidm/internal/user/username                         | PUT            | Adds a new internal user, or changes the password of an existing internal user. |
| /openidm/internal/user/username                         | PATCH          | Adds or removes roles of an internal user.                                      |
| /openidm/internal/role?\_queryFilter=true&\_fields=\_id | GET            | Lists internal roles.                                                           |
| /openidm/internal/role/role-id?\_fields=\*,authzMembers | GET            | Lists internal and managed users with the specified internal role.              |