DAdatadog
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

Request

  • Base URL
    https://api.datadoghq.com
  • URL
    https://api.datadoghq.com/api/v2/global_orgs
  • Auth
    • API key in header DD-API-KEY and API key in header DD-APPLICATION-KEY
    • or OAuth 2
      Authorization code: /oauth2/v1/authorize
      Token URL: /oauth2/v1/token scopes: user_access_read

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"
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.