---
title: Managed organizations
description: Organizations are exposed under the context path /managed/organization. The following table lists the REST commands associated with managed organizations.
component: pingidm
version: 8.1
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
keywords: ["REST API", "Organizations"]
---

# 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).