---
title: "Create a repository"
method: POST
path: "/v1/vcr/repository"
tags: ["vcr"]
---

# Create a repository

`POST /v1/vcr/repository`

Create a container registry repository for a project.

## Query parameters

- `teamId` string
- `slug` string

## Request body

- object
  - `projectId` string, required
  - `name` string, required — Single Docker repository name component.

## Response `200`

- object
  - `repository` VcrRepository, required — A Vercel Container Registry repository.
    - `id` string, required — Unique identifier of the repository.
    - `projectId` string, required — Identifier of the project the repository belongs to.
    - `name` string, required — Name of the repository.
    - `public` false | true, required — Whether the repository is public. Images in public repositories can be pulled by anyone. Defaults to `false` (private).
    - `createdAt` string, required — ISO 8601 timestamp of when the repository was created.
    - `updatedAt` string, required — ISO 8601 timestamp of when the repository was last updated.

## Other responses

- `400` — One of the provided values in the request body is invalid.
- `401` — The request is not authorized.
- `402` — The account is missing a payment so payment method must be updated
- `403` — You do not have permission to access this resource.
- `404`
- `409`
- `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)