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

# Clear a Team PM Scope

`DELETE /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/delete.ts> (a function with typed inputs; its response is checked against the schema)

Clears every scope key of a team's document on one integration. On jira this also sets the methodology to Kanban, as emptying the boards does

## Path parameters

- `team_id` integer, required: The team id

## Query parameters

- `integration_id` integer, required: The integration whose document is cleared

## Response `200`

Successful Response

- TeamScopeWriteResponseModel
  - `applied` TeamScopeAppliedModel[], required
    - `team_id` integer, required
    - `integration_id` integer, required
  - `rejected` TeamScopeRejectedModel[], required
    - `team_id` integer, required
    - `integration_id` integer, required
    - `status` integer, required: The HTTP status this document alone would have been refused with
    - `code` 'team_not_found' | 'integration_not_found' | 'provider_not_supported' | 'integration_read_only' | 'scope_key_not_writable' | 'invalid_scope' | 'entity_not_found' | 'license_limit' | 'write_failed', required: Why one (team, integration) document of a scope write was not applied.
    - `message` string, required

## Other responses

- `400`: Bad Request, or every document was refused for different reasons
- `401`: Unauthorized
- `403`: The caller may not change PM configuration, or the license limit
- `404`: Every document named a team or integration that was 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)