---
title: Managed users
description: User objects are stored in the repository and are exposed under the context path /managed/user. Many examples of REST calls related to this context path exist throughout this document. The following table lists available functionality associated with the /managed/user context path.
component: pingidm
version: 8.1
page_id: pingidm:rest-api-reference:endpoints/rest-managed-users
canonical_url: https://docs.pingidentity.com/pingidm/8.1/rest-api-reference/endpoints/rest-managed-users.html
keywords: ["REST API", "users", "Identities"]
---

# Managed users

User objects are stored in the repository and are exposed under the context path `/managed/user`. Many examples of REST calls related to this context path exist throughout this document. The following table lists available functionality associated with the `/managed/user` context path.

| URI                                                                       | HTTP Operation | Description                                                                                                                                                                                                                                                                                    |
| ------------------------------------------------------------------------- | -------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| /openidm/managed/user?\_queryFilter=true&\_fields=\_id                    | GET            | Lists the IDs of all the managed users in the repository.                                                                                                                                                                                                                                      |
| /openidm/managed/user?\_queryFilter=true                                  | GET            | Lists all info for the managed users in the repository.                                                                                                                                                                                                                                        |
| /openidm/managed/user?\_queryFilter=filter                                | GET            | Queries the managed user object with the defined filter.                                                                                                                                                                                                                                       |
| /openidm/managed/user/\_id                                                | GET            | Returns the JSON representation of a specific user.                                                                                                                                                                                                                                            |
| /openidm/managed/user/\_id                                                | PUT            | Creates a new user.                                                                                                                                                                                                                                                                            |
| /openidm/managed/user/\_id                                                | PUT            | Updates a user entry (replaces the entire entry).                                                                                                                                                                                                                                              |
| /openidm/managed/user?\_action=create                                     | POST           | Creates a new user.                                                                                                                                                                                                                                                                            |
| /openidm/managed/user?\_action=patch&\_queryId=for-userName\&uid=userName | POST           | Updates a user (can be used to replace the value of one or more existing attributes).

The access rule for this endpoint is:

{
  "pattern" : "managed/user/\*",
  "roles" : "internal/role/openidm-authorized",
  "methods" : "patch",
  "actions" : ""
} |
| /openidm/managed/user/\_id                                                | PATCH          | Updates specified fields of a user entry.                                                                                                                                                                                                                                                      |
| /openidm/managed/user/\_id                                                | DELETE         | Deletes a user entry.                                                                                                                                                                                                                                                                          |

For a number of sample commands that show how to manage users over REST, refer to [Users](../../objects-guide/users.html).