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

# Get team sync configurations

`GET /api/v2/team/sync`

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.net/datadog/apis/api-v2.md) · [All operations](https://skmtc.net/datadog/apis/api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/datadog/api-v2/versions/da68bf029e4c/schema)