---
title: "Add a repository permission"
method: POST
path: "/v1/vcr/repository/{idOrName}/permissions"
tags: ["vcr"]
---

# Add a repository permission

`POST /v1/vcr/repository/{idOrName}/permissions`

Grant a team access to a VCR repository. Sharing applies to the whole repository.

## Path parameters

- `idOrName` string, required

## Query parameters

- `projectId` string, required
- `teamId` string
- `slug` string

## Request body

- object
  - `teamId` string — ID of a team that is granted access to a repository.
  - `teamSlug` string — Slug of a team that is granted access to a repository.

## Response `200`

- object
  - `permission` VcrRepositoryPermission, required — A team's access grant to a Vercel Container Registry repository.
    - `repositoryId` string, required — Identifier of the repository the permission grants access to.
    - `teamId` string, required — Identifier of the team that is granted access to the repository.
    - `teamSlug` string, required — Slug of the team that is granted access to the repository.
    - `createdAt` string, required — ISO 8601 timestamp of when the permission was created.

## Other responses

- `400` — One of the provided values in the request body is invalid. One of the provided values in the request query is invalid.
- `401` — The request is not authorized.
- `403` — You do not have permission to access this resource.
- `404`
- `410`

---

[API](https://skmtc.net/vercel/apis/api.md) · [All operations](https://skmtc.net/vercel/apis/api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vercel/api/versions/61d1ba3f6dac/schema)