---
title: Managed organizations
description: REST endpoints for creating, reading, updating, deleting, and querying PingIDM managed organizations
component: pingidm
version: 7.5
page_id: pingidm:rest-api-reference:endpoints/rest-managed-organizations
canonical_url: https://docs.pingidentity.com/pingidm/8.1/rest-api-reference/endpoints/rest-managed-organizations.html
llms_txt: https://docs.pingidentity.com/pingidm/llms.txt
docs_for_agents: https://developer.pingidentity.com/build-with-ai/docs-for-agents.md
keywords: ["REST API", "Organizations"]
superseded_by: https://docs.pingidentity.com/pingidm/8.1/rest-api-reference/endpoints/rest-managed-organizations.html
---

# Managed organizations

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

| URI                                                            | HTTP Operation | Description                                                 |
| -------------------------------------------------------------- | -------------- | ----------------------------------------------------------- |
| /openidm/managed/organization?\_queryFilter=true&\_fields=\_id | GET            | Lists the IDs of all managed organizations.                 |
| /openidm/managed/organization?\_queryFilter=filter             | GET            | Queries managed organizations with the defined filter.      |
| /openidm/managed/organization/\_id                             | GET            | Returns the JSON representation of a specific organization. |
| /openidm/managed/organization/\_id                             | PUT            | Creates an organization with a user-defined ID.             |
| /openidm/managed/organization/\_id                             | PUT            | Updates an organization (replaces the entire object).       |
| /openidm/managed/organization?\_action=create                  | POST           | Creates a new organization with a system-generated ID.      |
| /openidm/managed/organization/\_id                             | DELETE         | Deletes an organization.                                    |

For a number of sample commands that show how to manage organizations over REST, refer to [Managed Organizations](../../objects-guide/managed-objects.html#managed-orgs).