Teams

List team connections

Returns all team connections.

get/api/v2/team/connections

Request

  • Base URL
    https://api.datadoghq.com
  • URL
    https://api.datadoghq.com/api/v2/team/connections
  • 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: teams_read

Query parameters

page[size]integer
Example:10

Size for a given page. The maximum allowed value is 100.

page[number]integer

Specific page number to return.

filter[sources]string[]

Filter team connections by external source systems.

[
  "github"
]
filter[team_ids]string[]

Filter team connections by Datadog team IDs.

[
  "12345678-1234-5678-9abc-123456789012"
]
filter[connected_team_ids]string[]

Filter team connections by connected team IDs from external systems.

[
  "@MyGitHubAccount/my-team-name"
]
filter[connection_ids]string[]

Filter team connections by connection IDs.

[
  "12345678-1234-5678-9abc-123456789012"
]

Response

OK

Example response

{
  "data": [
    {
      "attributes": {
        "managed_by": "github_sync",
        "source": "github"
      },
      "id": "12345678-1234-5678-9abc-123456789012",
      "relationships": {
        "connected_team": {
          "data": {
            "id": "@GitHubOrg/team-handle",
            "type": "github_team"
          }
        },
        "team": {
          "data": {
            "id": "87654321-4321-8765-dcba-210987654321",
            "type": "team"
          }
        }
      },
      "type": "team_connection"
    }
  ],
  "meta": {
    "page": {
      "type": "number_size"
    }
  }
}

Changes

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