---
title: Organizations
description: Datadog, the leading service for cloud-scale monitoring.
breadcrumbs: Docs > API Reference > Organizations
---

> For the complete documentation index, see [llms.txt](https://docs.datadoghq.com/llms.txt).

# Organizations

Create, edit, and manage your organizations. Read more about [multi-org accounts](https://docs.datadoghq.com/account_management/multi_organization.md).

## [Create a child organization →](https://docs.datadoghq.com/api/latest/organizations/create-a-child-organization.md){% #create-a-child-organization %}

| Datadog site      | API endpoint                                  |
| ----------------- | --------------------------------------------- |
| ap1.datadoghq.com | POST https://api.ap1.datadoghq.com/api/v1/org |
| ap2.datadoghq.com | POST https://api.ap2.datadoghq.com/api/v1/org |
| app.datadoghq.eu  | POST https://api.datadoghq.eu/api/v1/org      |
| app.ddog-gov.com  | POST https://api.ddog-gov.com/api/v1/org      |
| us2.ddog-gov.com  | POST https://api.us2.ddog-gov.com/api/v1/org  |
| uk1.datadoghq.com | POST https://api.uk1.datadoghq.com/api/v1/org |
| app.datadoghq.com | POST https://api.datadoghq.com/api/v1/org     |
| us3.datadoghq.com | POST https://api.us3.datadoghq.com/api/v1/org |
| us5.datadoghq.com | POST https://api.us5.datadoghq.com/api/v1/org |

## [List Org Configs →](https://docs.datadoghq.com/api/latest/organizations/list-org-configs.md){% #list-org-configs %}

| Datadog site      | API endpoint                                         |
| ----------------- | ---------------------------------------------------- |
| ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/org_configs |
| ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/org_configs |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v2/org_configs      |
| app.ddog-gov.com  | GET https://api.ddog-gov.com/api/v2/org_configs      |
| us2.ddog-gov.com  | GET https://api.us2.ddog-gov.com/api/v2/org_configs  |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/api/v2/org_configs |
| app.datadoghq.com | GET https://api.datadoghq.com/api/v2/org_configs     |
| us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/org_configs |
| us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/org_configs |

## [Get a specific Org Config value →](https://docs.datadoghq.com/api/latest/organizations/get-a-specific-org-config-value.md){% #get-a-specific-org-config-value %}

| Datadog site      | API endpoint                                                           |
| ----------------- | ---------------------------------------------------------------------- |
| ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/org_configs/{org_config_name} |
| ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/org_configs/{org_config_name} |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v2/org_configs/{org_config_name}      |
| app.ddog-gov.com  | GET https://api.ddog-gov.com/api/v2/org_configs/{org_config_name}      |
| us2.ddog-gov.com  | GET https://api.us2.ddog-gov.com/api/v2/org_configs/{org_config_name}  |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/api/v2/org_configs/{org_config_name} |
| app.datadoghq.com | GET https://api.datadoghq.com/api/v2/org_configs/{org_config_name}     |
| us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/org_configs/{org_config_name} |
| us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/org_configs/{org_config_name} |

## [List your managed organizations →](https://docs.datadoghq.com/api/latest/organizations/list-your-managed-organizations.md){% #list-your-managed-organizations %}

| Datadog site      | API endpoint                                 |
| ----------------- | -------------------------------------------- |
| ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/org |
| ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/org |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v2/org      |
| app.ddog-gov.com  | GET https://api.ddog-gov.com/api/v2/org      |
| us2.ddog-gov.com  | GET https://api.us2.ddog-gov.com/api/v2/org  |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/api/v2/org |
| app.datadoghq.com | GET https://api.datadoghq.com/api/v2/org     |
| us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/org |
| us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/org |

## [Get organization information →](https://docs.datadoghq.com/api/latest/organizations/get-organization-information.md){% #get-organization-information %}

| Datadog site      | API endpoint                                             |
| ----------------- | -------------------------------------------------------- |
| ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v1/org/{public_id} |
| ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v1/org/{public_id} |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v1/org/{public_id}      |
| app.ddog-gov.com  | GET https://api.ddog-gov.com/api/v1/org/{public_id}      |
| us2.ddog-gov.com  | GET https://api.us2.ddog-gov.com/api/v1/org/{public_id}  |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/api/v1/org/{public_id} |
| app.datadoghq.com | GET https://api.datadoghq.com/api/v1/org/{public_id}     |
| us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v1/org/{public_id} |
| us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v1/org/{public_id} |

## [Update a specific Org Config →](https://docs.datadoghq.com/api/latest/organizations/update-a-specific-org-config.md){% #update-a-specific-org-config %}

| Datadog site      | API endpoint                                                             |
| ----------------- | ------------------------------------------------------------------------ |
| ap1.datadoghq.com | PATCH https://api.ap1.datadoghq.com/api/v2/org_configs/{org_config_name} |
| ap2.datadoghq.com | PATCH https://api.ap2.datadoghq.com/api/v2/org_configs/{org_config_name} |
| app.datadoghq.eu  | PATCH https://api.datadoghq.eu/api/v2/org_configs/{org_config_name}      |
| app.ddog-gov.com  | PATCH https://api.ddog-gov.com/api/v2/org_configs/{org_config_name}      |
| us2.ddog-gov.com  | PATCH https://api.us2.ddog-gov.com/api/v2/org_configs/{org_config_name}  |
| uk1.datadoghq.com | PATCH https://api.uk1.datadoghq.com/api/v2/org_configs/{org_config_name} |
| app.datadoghq.com | PATCH https://api.datadoghq.com/api/v2/org_configs/{org_config_name}     |
| us3.datadoghq.com | PATCH https://api.us3.datadoghq.com/api/v2/org_configs/{org_config_name} |
| us5.datadoghq.com | PATCH https://api.us5.datadoghq.com/api/v2/org_configs/{org_config_name} |

## [Update your organization →](https://docs.datadoghq.com/api/latest/organizations/update-your-organization.md){% #update-your-organization %}

| Datadog site      | API endpoint                                             |
| ----------------- | -------------------------------------------------------- |
| ap1.datadoghq.com | PUT https://api.ap1.datadoghq.com/api/v1/org/{public_id} |
| ap2.datadoghq.com | PUT https://api.ap2.datadoghq.com/api/v1/org/{public_id} |
| app.datadoghq.eu  | PUT https://api.datadoghq.eu/api/v1/org/{public_id}      |
| app.ddog-gov.com  | PUT https://api.ddog-gov.com/api/v1/org/{public_id}      |
| us2.ddog-gov.com  | PUT https://api.us2.ddog-gov.com/api/v1/org/{public_id}  |
| uk1.datadoghq.com | PUT https://api.uk1.datadoghq.com/api/v1/org/{public_id} |
| app.datadoghq.com | PUT https://api.datadoghq.com/api/v1/org/{public_id}     |
| us3.datadoghq.com | PUT https://api.us3.datadoghq.com/api/v1/org/{public_id} |
| us5.datadoghq.com | PUT https://api.us5.datadoghq.com/api/v1/org/{public_id} |

## [Upload IdP metadata →](https://docs.datadoghq.com/api/latest/organizations/upload-idp-metadata.md){% #upload-idp-metadata %}

| Datadog site      | API endpoint                                                               |
| ----------------- | -------------------------------------------------------------------------- |
| ap1.datadoghq.com | POST https://api.ap1.datadoghq.com/api/v2/saml_configurations/idp_metadata |
| ap2.datadoghq.com | POST https://api.ap2.datadoghq.com/api/v2/saml_configurations/idp_metadata |
| app.datadoghq.eu  | POST https://api.datadoghq.eu/api/v2/saml_configurations/idp_metadata      |
| app.ddog-gov.com  | POST https://api.ddog-gov.com/api/v2/saml_configurations/idp_metadata      |
| us2.ddog-gov.com  | POST https://api.us2.ddog-gov.com/api/v2/saml_configurations/idp_metadata  |
| uk1.datadoghq.com | POST https://api.uk1.datadoghq.com/api/v2/saml_configurations/idp_metadata |
| app.datadoghq.com | POST https://api.datadoghq.com/api/v2/saml_configurations/idp_metadata     |
| us3.datadoghq.com | POST https://api.us3.datadoghq.com/api/v2/saml_configurations/idp_metadata |
| us5.datadoghq.com | POST https://api.us5.datadoghq.com/api/v2/saml_configurations/idp_metadata |

## [List SAML configurations →](https://docs.datadoghq.com/api/latest/organizations/list-saml-configurations.md){% #list-saml-configurations %}

| Datadog site      | API endpoint                                                 |
| ----------------- | ------------------------------------------------------------ |
| ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/saml_configurations |
| ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/saml_configurations |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v2/saml_configurations      |
| app.ddog-gov.com  | GET https://api.ddog-gov.com/api/v2/saml_configurations      |
| us2.ddog-gov.com  | GET https://api.us2.ddog-gov.com/api/v2/saml_configurations  |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/api/v2/saml_configurations |
| app.datadoghq.com | GET https://api.datadoghq.com/api/v2/saml_configurations     |
| us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/saml_configurations |
| us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/saml_configurations |

## [Spin-off Child Organization →](https://docs.datadoghq.com/api/latest/organizations/spin-off-child-organization.md){% #spin-off-child-organization %}

| Datadog site      | API endpoint                                                        |
| ----------------- | ------------------------------------------------------------------- |
| ap1.datadoghq.com | POST https://api.ap1.datadoghq.com/api/v1/org/{public_id}/downgrade |
| ap2.datadoghq.com | POST https://api.ap2.datadoghq.com/api/v1/org/{public_id}/downgrade |
| app.datadoghq.eu  | POST https://api.datadoghq.eu/api/v1/org/{public_id}/downgrade      |
| app.ddog-gov.com  | POST https://api.ddog-gov.com/api/v1/org/{public_id}/downgrade      |
| us2.ddog-gov.com  | POST https://api.us2.ddog-gov.com/api/v1/org/{public_id}/downgrade  |
| uk1.datadoghq.com | POST https://api.uk1.datadoghq.com/api/v1/org/{public_id}/downgrade |
| app.datadoghq.com | POST https://api.datadoghq.com/api/v1/org/{public_id}/downgrade     |
| us3.datadoghq.com | POST https://api.us3.datadoghq.com/api/v1/org/{public_id}/downgrade |
| us5.datadoghq.com | POST https://api.us5.datadoghq.com/api/v1/org/{public_id}/downgrade |

## [Get a SAML configuration →](https://docs.datadoghq.com/api/latest/organizations/get-a-saml-configuration.md){% #get-a-saml-configuration %}

| Datadog site      | API endpoint                                                                    |
| ----------------- | ------------------------------------------------------------------------------- |
| ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/saml_configurations/{saml_config_uuid} |
| ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/saml_configurations/{saml_config_uuid} |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v2/saml_configurations/{saml_config_uuid}      |
| app.ddog-gov.com  | GET https://api.ddog-gov.com/api/v2/saml_configurations/{saml_config_uuid}      |
| us2.ddog-gov.com  | GET https://api.us2.ddog-gov.com/api/v2/saml_configurations/{saml_config_uuid}  |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/api/v2/saml_configurations/{saml_config_uuid} |
| app.datadoghq.com | GET https://api.datadoghq.com/api/v2/saml_configurations/{saml_config_uuid}     |
| us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/saml_configurations/{saml_config_uuid} |
| us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/saml_configurations/{saml_config_uuid} |

## [Update a SAML configuration →](https://docs.datadoghq.com/api/latest/organizations/update-a-saml-configuration.md){% #update-a-saml-configuration %}

| Datadog site      | API endpoint                                                                      |
| ----------------- | --------------------------------------------------------------------------------- |
| ap1.datadoghq.com | PATCH https://api.ap1.datadoghq.com/api/v2/saml_configurations/{saml_config_uuid} |
| ap2.datadoghq.com | PATCH https://api.ap2.datadoghq.com/api/v2/saml_configurations/{saml_config_uuid} |
| app.datadoghq.eu  | PATCH https://api.datadoghq.eu/api/v2/saml_configurations/{saml_config_uuid}      |
| app.ddog-gov.com  | PATCH https://api.ddog-gov.com/api/v2/saml_configurations/{saml_config_uuid}      |
| us2.ddog-gov.com  | PATCH https://api.us2.ddog-gov.com/api/v2/saml_configurations/{saml_config_uuid}  |
| uk1.datadoghq.com | PATCH https://api.uk1.datadoghq.com/api/v2/saml_configurations/{saml_config_uuid} |
| app.datadoghq.com | PATCH https://api.datadoghq.com/api/v2/saml_configurations/{saml_config_uuid}     |
| us3.datadoghq.com | PATCH https://api.us3.datadoghq.com/api/v2/saml_configurations/{saml_config_uuid} |
| us5.datadoghq.com | PATCH https://api.us5.datadoghq.com/api/v2/saml_configurations/{saml_config_uuid} |

## [Update organization SAML preferences →](https://docs.datadoghq.com/api/latest/organizations/update-organization-saml-preferences.md) preview{% #update-organization-saml-preferences %}

| Datadog site      | API endpoint                                                       |
| ----------------- | ------------------------------------------------------------------ |
| ap1.datadoghq.com | PATCH https://api.ap1.datadoghq.com/api/v2/org/saml_configurations |
| ap2.datadoghq.com | PATCH https://api.ap2.datadoghq.com/api/v2/org/saml_configurations |
| app.datadoghq.eu  | PATCH https://api.datadoghq.eu/api/v2/org/saml_configurations      |
| app.ddog-gov.com  | PATCH https://api.ddog-gov.com/api/v2/org/saml_configurations      |
| us2.ddog-gov.com  | PATCH https://api.us2.ddog-gov.com/api/v2/org/saml_configurations  |
| uk1.datadoghq.com | PATCH https://api.uk1.datadoghq.com/api/v2/org/saml_configurations |
| app.datadoghq.com | PATCH https://api.datadoghq.com/api/v2/org/saml_configurations     |
| us3.datadoghq.com | PATCH https://api.us3.datadoghq.com/api/v2/org/saml_configurations |
| us5.datadoghq.com | PATCH https://api.us5.datadoghq.com/api/v2/org/saml_configurations |

## [List global orgs →](https://docs.datadoghq.com/api/latest/organizations/list-global-orgs.md){% #list-global-orgs %}

| Datadog site      | API endpoint                                         |
| ----------------- | ---------------------------------------------------- |
| ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/global_orgs |
| ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/global_orgs |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v2/global_orgs      |
| app.ddog-gov.com  | GET https://api.ddog-gov.com/api/v2/global_orgs      |
| us2.ddog-gov.com  | GET https://api.us2.ddog-gov.com/api/v2/global_orgs  |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/api/v2/global_orgs |
| app.datadoghq.com | GET https://api.datadoghq.com/api/v2/global_orgs     |
| us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/global_orgs |
| us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/global_orgs |

## [Update the maximum session duration →](https://docs.datadoghq.com/api/latest/organizations/update-the-maximum-session-duration.md){% #update-the-maximum-session-duration %}

| Datadog site      | API endpoint                                                                    |
| ----------------- | ------------------------------------------------------------------------------- |
| ap1.datadoghq.com | PUT https://api.ap1.datadoghq.com/api/v2/login/org_configs/max_session_duration |
| ap2.datadoghq.com | PUT https://api.ap2.datadoghq.com/api/v2/login/org_configs/max_session_duration |
| app.datadoghq.eu  | PUT https://api.datadoghq.eu/api/v2/login/org_configs/max_session_duration      |
| app.ddog-gov.com  | PUT https://api.ddog-gov.com/api/v2/login/org_configs/max_session_duration      |
| us2.ddog-gov.com  | PUT https://api.us2.ddog-gov.com/api/v2/login/org_configs/max_session_duration  |
| uk1.datadoghq.com | PUT https://api.uk1.datadoghq.com/api/v2/login/org_configs/max_session_duration |
| app.datadoghq.com | PUT https://api.datadoghq.com/api/v2/login/org_configs/max_session_duration     |
| us3.datadoghq.com | PUT https://api.us3.datadoghq.com/api/v2/login/org_configs/max_session_duration |
| us5.datadoghq.com | PUT https://api.us5.datadoghq.com/api/v2/login/org_configs/max_session_duration |