---
title: "Update your organization"
method: PUT
path: "/api/v1/org/{public_id}"
tags: ["Organizations"]
---

# Update your organization

`PUT /api/v1/org/{public_id}`

Update your organization.

## Path parameters

- `public_id` string, required

## Request body

- Organization — Create, edit, and manage organizations.
  - `billing` OrganizationBilling — A JSON array of billing type.
    - `type` string — The type of billing. Only `parent_billing` is supported.
  - `created` string — Date of the organization creation.
  - `description` string — Description of the organization.
  - `name` string — The name of the child organization, limited to 32 characters.
  - `public_id` string — The `public_id` of the organization you are operating within.
  - `settings` OrganizationSettings — A JSON array of settings.
    - `private_widget_share` boolean — Whether or not the organization users can share widgets outside of Datadog.
    - `saml` OrganizationSettingsSaml — Set the boolean property enabled to enable or disable single sign on with SAML. See the SAML documentation for more information about all SAML settings.
      - `enabled` boolean — Whether or not SAML is enabled for this organization.
    - `saml_autocreate_access_role` 'st' | 'adm' | 'ro' | 'ERROR', nullable — The access role of the user. Options are **st** (standard user), **adm** (admin user), or **ro** (read-only user).
    - `saml_autocreate_users_domains` OrganizationSettingsSamlAutocreateUsersDomains — Has two properties, `enabled` (boolean) and `domains`, which is a list of domains without the @ symbol.
      - `domains` string[] — List of domains where the SAML automated user creation is enabled.
      - `enabled` boolean — Whether or not the automated user creation based on SAML domain is enabled.
    - `saml_can_be_enabled` boolean — Whether or not SAML can be enabled for this organization.
    - `saml_idp_endpoint` string — Identity provider endpoint for SAML authentication.
    - `saml_idp_initiated_login` OrganizationSettingsSamlIdpInitiatedLogin — Has one property enabled (boolean).
      - `enabled` boolean — Whether SAML IdP initiated login is enabled, learn more in the [SAML documentation](https://docs.datadoghq.com/account_management/saml/#idp-initiated-login).
    - `saml_idp_metadata_uploaded` boolean — Whether or not a SAML identity provider metadata file was provided to the Datadog organization.
    - `saml_login_url` string — URL for SAML logging.
    - `saml_strict_mode` OrganizationSettingsSamlStrictMode — Has one property enabled (boolean).
      - `enabled` boolean — Whether or not the SAML strict mode is enabled. If true, all users must log in with SAML. Learn more on the [SAML Strict documentation](https://docs.datadoghq.com/account_management/saml/#saml-strict).
  - `subscription` OrganizationSubscription — Subscription definition.
    - `type` string — The subscription type. Types available are `trial`, `free`, and `pro`.
  - `trial` boolean — Only available for MSP customers. Allows child organizations to be created on a trial plan.

## Response `200`

OK

- OrganizationResponse — Response with an organization.
  - `org` Organization — Create, edit, and manage organizations.
    - `billing` OrganizationBilling — A JSON array of billing type.
      - `type` string — The type of billing. Only `parent_billing` is supported.
    - `created` string — Date of the organization creation.
    - `description` string — Description of the organization.
    - `name` string — The name of the child organization, limited to 32 characters.
    - `public_id` string — The `public_id` of the organization you are operating within.
    - `settings` OrganizationSettings — A JSON array of settings.
      - `private_widget_share` boolean — Whether or not the organization users can share widgets outside of Datadog.
      - `saml` OrganizationSettingsSaml — Set the boolean property enabled to enable or disable single sign on with SAML. See the SAML documentation for more information about all SAML settings.
        - `enabled` boolean — Whether or not SAML is enabled for this organization.
      - `saml_autocreate_access_role` 'st' | 'adm' | 'ro' | 'ERROR', nullable — The access role of the user. Options are **st** (standard user), **adm** (admin user), or **ro** (read-only user).
      - `saml_autocreate_users_domains` OrganizationSettingsSamlAutocreateUsersDomains — Has two properties, `enabled` (boolean) and `domains`, which is a list of domains without the @ symbol.
        - `domains` string[] — List of domains where the SAML automated user creation is enabled.
        - `enabled` boolean — Whether or not the automated user creation based on SAML domain is enabled.
      - `saml_can_be_enabled` boolean — Whether or not SAML can be enabled for this organization.
      - `saml_idp_endpoint` string — Identity provider endpoint for SAML authentication.
      - `saml_idp_initiated_login` OrganizationSettingsSamlIdpInitiatedLogin — Has one property enabled (boolean).
        - `enabled` boolean — Whether SAML IdP initiated login is enabled, learn more in the [SAML documentation](https://docs.datadoghq.com/account_management/saml/#idp-initiated-login).
      - `saml_idp_metadata_uploaded` boolean — Whether or not a SAML identity provider metadata file was provided to the Datadog organization.
      - `saml_login_url` string — URL for SAML logging.
      - `saml_strict_mode` OrganizationSettingsSamlStrictMode — Has one property enabled (boolean).
        - `enabled` boolean — Whether or not the SAML strict mode is enabled. If true, all users must log in with SAML. Learn more on the [SAML Strict documentation](https://docs.datadoghq.com/account_management/saml/#saml-strict).
    - `subscription` OrganizationSubscription — Subscription definition.
      - `type` string — The subscription type. Types available are `trial`, `free`, and `pro`.
    - `trial` boolean — Only available for MSP customers. Allows child organizations to be created on a trial plan.

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `429` — Too many requests

---

[API](https://skmtc.net/datadog/apis/api-v1.md) · [All operations](https://skmtc.net/datadog/apis/api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/datadog/api-v1/revisions/ca5871004d26/schema)