---
title: Organizations
description: Create, edit, and manage your organizations. Read more about multi-org accounts.
breadcrumbs: Docs > API > Organizations
---

> For the complete documentation index, see [llms.txt](https://dnd37xeb23o8n.cloudfront.net/stefon.simmons/docs-astro-web-10435/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://dnd37xeb23o8n.cloudfront.net/stefon.simmons/docs-astro-web-10435/api/latest/organizations/create-a-child-organization.md)

| Datadog site      | API endpoint                                  |
| ----------------- | --------------------------------------------- |
| 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 |
| app.datadoghq.eu  | POST https://api.datadoghq.eu/api/v1/org      |
| ap1.datadoghq.com | POST https://api.ap1.datadoghq.com/api/v1/org |
| ap2.datadoghq.com | POST https://api.ap2.datadoghq.com/api/v1/org |
| uk1.datadoghq.com | POST https://api.uk1.datadoghq.com/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  |

## [List Org Configs](https://dnd37xeb23o8n.cloudfront.net/stefon.simmons/docs-astro-web-10435/api/latest/organizations/list-org-configs.md)

| Datadog site      | API endpoint                                         |
| ----------------- | ---------------------------------------------------- |
| 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 |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v2/org_configs      |
| 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 |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/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  |

## [Get a specific Org Config value](https://dnd37xeb23o8n.cloudfront.net/stefon.simmons/docs-astro-web-10435/api/latest/organizations/get-a-specific-org-config-value.md)

| Datadog site      | API endpoint                                                           |
| ----------------- | ---------------------------------------------------------------------- |
| 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} |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v2/org_configs/{org_config_name}      |
| 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} |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/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}  |

## [List your managed organizations](https://dnd37xeb23o8n.cloudfront.net/stefon.simmons/docs-astro-web-10435/api/latest/organizations/list-your-managed-organizations.md)

| Datadog site      | API endpoint                                 |
| ----------------- | -------------------------------------------- |
| 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 |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v2/org      |
| ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/org |
| ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/org |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/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  |

## [Get organization information](https://dnd37xeb23o8n.cloudfront.net/stefon.simmons/docs-astro-web-10435/api/latest/organizations/get-organization-information.md)

| Datadog site      | API endpoint                                             |
| ----------------- | -------------------------------------------------------- |
| 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} |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v1/org/{public_id}      |
| 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} |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/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}  |

## [Update a specific Org Config](https://dnd37xeb23o8n.cloudfront.net/stefon.simmons/docs-astro-web-10435/api/latest/organizations/update-a-specific-org-config.md)

| Datadog site      | API endpoint                                                             |
| ----------------- | ------------------------------------------------------------------------ |
| 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} |
| app.datadoghq.eu  | PATCH https://api.datadoghq.eu/api/v2/org_configs/{org_config_name}      |
| 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} |
| uk1.datadoghq.com | PATCH https://api.uk1.datadoghq.com/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}  |

## [Update your organization](https://dnd37xeb23o8n.cloudfront.net/stefon.simmons/docs-astro-web-10435/api/latest/organizations/update-your-organization.md)

| Datadog site      | API endpoint                                             |
| ----------------- | -------------------------------------------------------- |
| 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} |
| app.datadoghq.eu  | PUT https://api.datadoghq.eu/api/v1/org/{public_id}      |
| 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} |
| uk1.datadoghq.com | PUT https://api.uk1.datadoghq.com/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}  |

## [Upload IdP metadata](https://dnd37xeb23o8n.cloudfront.net/stefon.simmons/docs-astro-web-10435/api/latest/organizations/upload-idp-metadata.md)

| Datadog site      | API endpoint                                                               |
| ----------------- | -------------------------------------------------------------------------- |
| 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 |
| app.datadoghq.eu  | POST https://api.datadoghq.eu/api/v2/saml_configurations/idp_metadata      |
| 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 |
| uk1.datadoghq.com | POST https://api.uk1.datadoghq.com/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  |

## [List SAML configurations](https://dnd37xeb23o8n.cloudfront.net/stefon.simmons/docs-astro-web-10435/api/latest/organizations/list-saml-configurations.md)

| Datadog site      | API endpoint                                                 |
| ----------------- | ------------------------------------------------------------ |
| 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 |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v2/saml_configurations      |
| 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 |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/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  |

## [Spin-off Child Organization](https://dnd37xeb23o8n.cloudfront.net/stefon.simmons/docs-astro-web-10435/api/latest/organizations/spin-off-child-organization.md)

| Datadog site      | API endpoint                                                        |
| ----------------- | ------------------------------------------------------------------- |
| 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 |
| app.datadoghq.eu  | POST https://api.datadoghq.eu/api/v1/org/{public_id}/downgrade      |
| 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 |
| uk1.datadoghq.com | POST https://api.uk1.datadoghq.com/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  |

## [Get a SAML configuration](https://dnd37xeb23o8n.cloudfront.net/stefon.simmons/docs-astro-web-10435/api/latest/organizations/get-a-saml-configuration.md)

| Datadog site      | API endpoint                                                                    |
| ----------------- | ------------------------------------------------------------------------------- |
| 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} |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v2/saml_configurations/{saml_config_uuid}      |
| 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} |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/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}  |

## [Update a SAML configuration](https://dnd37xeb23o8n.cloudfront.net/stefon.simmons/docs-astro-web-10435/api/latest/organizations/update-a-saml-configuration.md)

| Datadog site      | API endpoint                                                                      |
| ----------------- | --------------------------------------------------------------------------------- |
| 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} |
| app.datadoghq.eu  | PATCH https://api.datadoghq.eu/api/v2/saml_configurations/{saml_config_uuid}      |
| 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} |
| uk1.datadoghq.com | PATCH https://api.uk1.datadoghq.com/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}  |

## [Update organization SAML preferences](https://dnd37xeb23o8n.cloudfront.net/stefon.simmons/docs-astro-web-10435/api/latest/organizations/update-organization-saml-preferences.md) (preview)

| Datadog site      | API endpoint                                                       |
| ----------------- | ------------------------------------------------------------------ |
| 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 |
| app.datadoghq.eu  | PATCH https://api.datadoghq.eu/api/v2/org/saml_configurations      |
| 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 |
| uk1.datadoghq.com | PATCH https://api.uk1.datadoghq.com/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  |

## [List global orgs](https://dnd37xeb23o8n.cloudfront.net/stefon.simmons/docs-astro-web-10435/api/latest/organizations/list-global-orgs.md)

| Datadog site      | API endpoint                                         |
| ----------------- | ---------------------------------------------------- |
| 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 |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v2/global_orgs      |
| 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 |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/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  |

## [Update the maximum session duration](https://dnd37xeb23o8n.cloudfront.net/stefon.simmons/docs-astro-web-10435/api/latest/organizations/update-the-maximum-session-duration.md)

| Datadog site      | API endpoint                                                                    |
| ----------------- | ------------------------------------------------------------------------------- |
| 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 |
| app.datadoghq.eu  | PUT https://api.datadoghq.eu/api/v2/login/org_configs/max_session_duration      |
| 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 |
| uk1.datadoghq.com | PUT https://api.uk1.datadoghq.com/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  |