---
title: "Get Team PM Scope"
method: GET
path: "/api/v1/pm/config/teams/{team_id}/scope"
tags: ["PM Configuration"]
---

# Get Team PM Scope

`GET /api/v1/pm/config/teams/{team_id}/scope`

## Request

- Base URL: `https://public-api.linearb.io`
- URL: `https://public-api.linearb.io/api/v1/pm/config/teams/{team_id}/scope`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/linearb/apis/linearb-api/docs/api/v1/pm/config/teams/:team_id/scope/get.ts> (a function with typed inputs; its response is checked against the schema)

Reads a team's PM scope, one item per integration

## Path parameters

- `team_id` integer, required: The team id

## Query parameters

- `integration_ids` string, nullable: Comma-separated integration ids, at most 50 distinct. Omitted = every live integration of the organization

## Response `200`

Successful Response

- TeamScopeResponseModel
  - `team_id` integer, required
  - `team_name` string, nullable
  - `items` TeamScopeItemModel[], required
    - `integration_id` integer, required
    - `provider` string, required
    - `integration_name` string, nullable
    - `scope` TeamScopeDocumentModel, required
      - `boards` EntityRefModel[], nullable
        - `entity_provider_id` string, required
        - `name` string, nullable
      - `epics` ScopeEpicModel[], nullable
        - `entity_provider_id` string, required
        - `provider_key` string, nullable
      - `labels` ScopeLabelModel[], nullable
        - `name` string, required
      - `fields` ScopeFieldModel[], nullable
        - `entity_provider_id` string, required
        - `value` string[]
      - `project_team_areas` ProjectTeamAreasModel[], nullable
        - `project` EntityRefModel, required
          - `entity_provider_id` string, required
          - `name` string, nullable
        - `team` EntityRefModel, required
          - `entity_provider_id` string, required
          - `name` string, nullable
        - `areas` EntityRefModel[]
          - `entity_provider_id` string, required
          - `name` string, nullable
    - `methodology` string, required

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `405`: Method Not Allowed
- `409`: Conflict
- `500`: Internal Server Error
- `504`: Gateway Timeout

---

[API](https://skmtc.dev/linearb/apis/linearb-api.md) - [All operations](https://skmtc.dev/linearb/apis/linearb-api/llms.txt) - [OpenAPI document](https://skmtc.dev/linearb/apis/linearb-api/revisions/3aea06710db6?raw)