---
title: "Get team sync configurations"
method: GET
path: "/api/v2/team/sync"
tags: ["Teams"]
---

# Get team sync configurations

`GET /api/v2/team/sync`

## Request

- Base URL: `https://api.datadoghq.com`
- URL: `https://api.datadoghq.com/api/v2/team/sync`
- Auth: one of:
  - API key in header `DD-API-KEY` and API key in header `DD-APPLICATION-KEY`
  - OAuth 2
    - Authorization code: `/oauth2/v1/authorize`
    - Token URL: `/oauth2/v1/token` scopes: `teams_read`

Get all team synchronization configurations.
Returns a list of configurations used for linking or provisioning teams with external sources like GitHub.

## Query parameters

- `filter[source]` 'github', required: The external source platform for team synchronization. Only "github" is supported.

## Response `200`

OK

- TeamSyncResponse: Team sync configurations response.
  - `data` TeamSyncData[]: List of team sync configurations
    - `attributes` TeamSyncAttributes, required: Team sync attributes.
      - `frequency` 'once' | 'continuously' | 'paused': How often the sync process should be run. Defaults to `once` when not provided.
      - `selection_state` TeamSyncSelectionStateItem[]: Specifies which teams or organizations to sync. When provided, synchronization is limited to the specified items and their subtrees.
        - `external_id` TeamSyncSelectionStateExternalId, required: The external identifier for a team or organization in the source platform.
          - `type` 'team' | 'organization', required: The type of external identifier for the selection state item. For GitHub synchronization, the allowed values are `team` and `organization`.
          - `value` string, required: The external identifier value from the source platform. For GitHub, this is the string representation of a GitHub organization ID or team ID.
        - `operation` 'include': The operation to perform on the selected hierarchy. When set to `include`, synchronization covers the referenced teams or organizations.
        - `scope` 'subtree': The scope of the selection. When set to `subtree`, synchronization includes the referenced team or organization and everything nested under it.
      - `source` 'github', required: The external source platform for team synchronization. Only "github" is supported.
      - `sync_membership` boolean: Whether to sync members from the external team to the Datadog team. Defaults to `false` when not provided.
      - `type` 'link' | 'provision', required: The type of synchronization operation. "link" connects teams by matching names. "provision" creates new teams when no match is found.
    - `id` string: The sync's identifier
    - `type` 'team_sync_bulk', required: Team sync bulk type.

## Other responses

- `403`: Forbidden
- `429`: Too many requests

---

[API](https://skmtc.dev/datadog/apis/datadog-api-v2-collection.md) - [All operations](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/llms.txt) - [OpenAPI document](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/revisions/da68bf029e4c?raw)