---
title: "List deployment teams"
method: POST
path: "/api/permissions/v2/deployments/{deploymentId}/teams/list"
tags: ["TeamsService"]
---

# List deployment teams

`POST /api/permissions/v2/deployments/{deploymentId}/teams/list`

List a deployment's Role-Based Access Control teams

## Path parameters

- `deploymentId` integer, required — The unique numerical identifier for the deployment.

## Request body

- ProtosPermissionsV2ListDeploymentTeamsRequest
  - `limit` string, int64 — Maximum number of items to return in a single page.
  - `cursor` string — Opaque cursor used for pagination. If not provided the first page will be returned.
  - `filter` ProtosPermissionsV2DeploymentTeamsFilter
    - `name` string — Filter teams by name (exact match only).

## Response `200`

OK

- ProtosPermissionsV2ListDeploymentTeamsResponse
  - `teams` ProtosPermissionsV2Team[]
    - `id` string, int64 — The unique numerical identifier for the team.
    - `deploymentId` string, int64 — The unique numerical identifier for the deployment.
    - `name` string — The name of this team.
    - `slug` string — The slug of this team's name.
    - `parentTeamId` string, int64 — The Team ID of this team's parent team. If unset, the team is an organization-level team.
    - `repositoryCount` string, int64 — The number of repositories directly assigned to this team.
    - `userCount` string, int64 — The number of users directly assigned to this team.
    - `childTeamCount` string, int64 — The number of teams directly assigned to this team.
    - `isProjectDefault` boolean — Whether new repositories are automatically assigned to this team.
    - `isUserDefault` boolean — Whether new users are automatically assigned to this team.
    - `authorizedScopes` string[] — The scopes the the caller has for this team. | value | description | |-------|---------------| | TEAM_SCOPE_DIRECT_MEMBER | Indicates that the user is a direct member of the team | | TEAM_SCOPE_MANAGE | Indicates that the user can manage the team |
  - `cursor` string — Opaque cursor used for pagination. If not provided the first page will be returned.

---

[API](https://skmtc.net/semgrep/apis/semgrep-web-app.md) · [All operations](https://skmtc.net/semgrep/apis/semgrep-web-app/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/semgrep/semgrep-web-app/versions/6483eeecd582/schema)