---
title: "Get team permissions"
method: POST
path: "/api/v2/teams/getPermissions"
tags: ["Teams"]
---

# Get team permissions

`POST /api/v2/teams/getPermissions`

## Request

- Base URL: `https://zeropath.com`
- URL: `https://zeropath.com/api/v2/teams/getPermissions`
- Auth: API key in header `X-ZeroPath-API-Token-Id` and API key in header `X-ZeroPath-API-Token-Secret`

Retrieve the full set of permissions currently assigned to a team, including organization-level, repository-level, and team self-management permissions.

## Request body

- TeamIdRequest
  - `organizationId` string
  - `id` string, required

## Response `200`

Team permissions

- TeamsGetPermissionsResponse
  - `organizationPerms` string[], required
  - `repoPerms` string[], required
  - `teamPerms` string[], required
  - `repositoryIds` string[], required
  - `tagIds` string[], required
  - `universalRepoPermissions` boolean, required
  - `repoAccess` union, required
    - object
      - `mode` 'universal', required
      - `perms` string[], required
    - object
      - `mode` 'selected', required
      - `perms` string[], required
      - `repositoryIds` string[], required
      - `tagIds` string[], required

## Other responses

- `400`: Error Response
- `401`: Error Response
- `404`: Error Response

---

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