---
title: Managed groups
description: Groups are exposed under the context path managed/realm-name_group. The following table lists the REST commands associated with managed groups.
component: pingoneaic
page_id: pingoneaic:idm-rest-api:endpoints/rest-managed-groups
canonical_url: https://docs.pingidentity.com/pingoneaic/idm-rest-api/endpoints/rest-managed-groups.html
---

# Managed groups

Groups are exposed under the context path `managed/realm-name_group`. The following table lists the REST commands associated with managed groups.

| URI                                                                 | HTTP Operation | Description                                                                                                                   |
| ------------------------------------------------------------------- | -------------- | ----------------------------------------------------------------------------------------------------------------------------- |
| /openidm/managed/realm-name\_group?\_queryFilter=true&\_fields=\_id | GET            | Returns the IDs of all managed groups.                                                                                        |
| /openidm/managed/realm-name\_group?\_queryFilter=filter             | GET            | Queries managed groups with the defined filter.                                                                               |
| /openidm/managed/realm-name\_group/\_id                             | GET            | Returns the JSON representation of a specific group.                                                                          |
| /openidm/managed/realm-name\_group/\_id?\_fields=name,members       | GET            | Returns the relationships (members) associated with a group.                                                                  |
| /openidm/managed/realm-name\_group/\_id/members?\_queryFilter=true  | GET            | Returns the members of a group.                                                                                               |
| /openidm/managed/realm-name\_group/\_id/members?\_action=create     | POST           | Adds a member to a group.                                                                                                     |
| /openidm/managed/realm-name\_group/\_id                             | PUT            | Updates a group by replacing the entire object with a new one. If no group entry exists with that `_id`, one will be created. |
| /openidm/managed/realm-name\_group?\_action=create                  | POST           | Creates a new group. `_id` and `name` will be the same.                                                                       |
| /openidm/managed/realm-name\_group/\_id                             | DELETE         | Deletes a group.                                                                                                              |

For additional commands and examples, refer to [Groups](../../idm-objects/groups.html).