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

# Managed organizations

Organizations are exposed under the context path `/managed/realm-name_organization`. The following table lists the REST commands associated with managed organizations.

| URI                                                                      | HTTP Operation | Description                                                                                                             |
| ------------------------------------------------------------------------ | -------------- | ----------------------------------------------------------------------------------------------------------------------- |
| `/openidm/managed/realm-name_organization?_queryFilter=true&_fields=_id` | GET            | Returns the IDs of all managed organizations.                                                                           |
| `/openidm/managed/realm-name_organization?_queryFilter=filter`           | GET            | Queries managed organizations with the defined filter.                                                                  |
| `/openidm/managed/realm-name_organization/_id`                           | GET            | Returns the JSON representation of a specific organization.                                                             |
| `/openidm/managed/realm-name_organization/_id`                           | PUT            | Creates an organization with a user-defined ID.                                                                         |
| `/openidm/managed/realm-name_organization/_id`                           | PUT            | Updates an organization by replacing the entire object. If no organization exists with that `_id`, one will be created. |
| `/openidm/managed/realm-name_organization?_action=create`                | POST           | Creates a new organization with a system-generated ID.                                                                  |
| `/openidm/managed/realm-name_organization/_id`                           | DELETE         | Deletes an organization.                                                                                                |

For additional commands and examples, refer to [Manage organizations over REST](../../idm-objects/manage-orgs-rest.html).