Sign in

v1

latestOpenAPI 3.0.02026-07-142351,1971.3 MB
Organizations

Create a child organization

Create a child organization.

This endpoint requires the multi-organization account feature and must be enabled by contacting support.

Once a new child organization is created, you can interact with it by using the org.public_id, api_key.key, and application_key.hash provided in the response.

post/api/v1/org

Request body

namestring required

The name of the new child-organization, limited to 32 characters.

Example request

{
  "billing": {
    "type": "parent_billing"
  },
  "name": "New child org",
  "subscription": {
    "type": "pro"
  }
}

Response

OK

Example response

{
  "api_key": {
    "created": "2019-08-02 15:31:07",
    "created_by": "john@example.com",
    "key": "1234512345123456abcabc912349abcd",
    "name": "example user"
  },
  "application_key": {
    "hash": "1234512345123459cda4eb9ced49a3d84fd0138c",
    "name": "example user",
    "owner": "example.com"
  },
  "org": {
    "billing": {
      "type": "parent_billing"
    },
    "created": "2019-09-26T17:28:28Z",
    "description": "some description",
    "name": "New child org",
    "public_id": "abcdef12345",
    "settings": {
      "saml_autocreate_access_role": "ro",
      "saml_autocreate_users_domains": {
        "domains": [
          "example.com"
        ]
      },
      "saml_idp_endpoint": "https://my.saml.endpoint",
      "saml_login_url": "https://my.saml.login.url"
    },
    "subscription": {
      "type": "pro"
    }
  },
  "user": {
    "access_role": "ro",
    "email": "test@datadoghq.com",
    "handle": "test@datadoghq.com",
    "icon": "/path/to/matching/gravatar/icon",
    "name": "test user",
    "verified": true
  }
}