v1

latestOpenAPI 3.0.02026-07-141,4077,1665.2 MB
Organizations

List global orgs

Returns organizations across regions for the authenticated user. The user_handle query parameter must match the authenticated user's handle.

get/api/v2/global_orgs

Query parameters

user_handlestring required
Example:user@example.com

The handle of the authenticated user.

page[limit]integer

Maximum number of results returned.

page[cursor]string

String to query the next page of results. This key is provided with each valid response from the API in meta.page.next_cursor.

Response

OK

Example response

{
  "data": [
    {
      "attributes": {
        "org": {
          "name": "Example Org",
          "public_id": "abcdef12345",
          "subdomain": "example",
          "uuid": "13d10a96-6ff2-49be-be7b-4f56ebb13335"
        },
        "redirect_url": "https://app.datadoghq.com/account/login/password?dd_oid=13d10a96-6ff2-49be-be7b-4f56ebb13335&login_hint=user%40example.com",
        "source_region": "us1.prod.dog",
        "user": {
          "handle": "user@example.com",
          "uuid": "cfab5cf9-5472-48ea-a79c-a64045f4f745"
        }
      },
      "type": "global_user_orgs"
    }
  ],
  "links": {
    "next": "https://app.datadoghq.com/api/v2/global_orgs?user_handle=user@example.com&page[limit]=100&page[cursor]=next-page",
    "self": "https://app.datadoghq.com/api/v2/global_orgs?user_handle=user@example.com&page[limit]=100"
  },
  "meta": {
    "page": {
      "limit": 100,
      "next_cursor": "next-page",
      "type": "cursor"
    }
  }
}