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

# Organizations
Copy pageCopied
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 →{% #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  |
| 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 →{% #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  |
| 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 →{% #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}  |
| 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 →{% #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  |
| 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 →{% #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}  |
| 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 →{% #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}  |
| 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 →{% #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}  |
| 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 →{% #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  |
| 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 →{% #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  |
| 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 →{% #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  |
| 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 →{% #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}  |
| 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 →{% #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}  |
| 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 → 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  |
| 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 →{% #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  |
| 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 →{% #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  |
| 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 |