---
title: "Push an image manifest"
method: PUT
path: "/v2/{teamSlug}/{projectSlug}/{repositoryName}/manifests/{reference}"
tags: ["vcr"]
---

# Push an image manifest

`PUT /v2/{teamSlug}/{projectSlug}/{repositoryName}/manifests/{reference}`

PUT /v2/:teamSlug/:projectSlug/:repositoryName/manifests/:reference Upload an image manifest. The digest is computed from the body and returned in the Docker-Content-Digest header.

## Path parameters

- `teamSlug` string, required — Single Docker repository team slug component.
- `projectSlug` string, required — Single Docker repository project slug component.
- `repositoryName` string, required — Single Docker repository name component.
- `reference` string, required — Manifest reference: a tag or digest.

## Response `201`

- unknown

## Other responses

- `400` — One of the provided values in the request query 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`
- `410`
- `413`

## Changes

- **2026-08-12** `b7b824605094` — 1 warning
  - changed the pattern of the `path` request parameter `teamSlug` from `^(?:[a-z0-9](?:[a-z0-9-]{0,46}[a-z0-9])?|team_[a-zA-Z0-9]+)$` to `^[a-z0-9](?:[a-z0-9-]{0,46}[a-z0-9])?$`
- **2026-08-11** `0a04f9c0168d` — 1 warning
  - changed the pattern of the `path` request parameter `teamSlug` from `^[a-z0-9](?:[a-z0-9-]{0,46}[a-z0-9])?$` to `^(?:[a-z0-9](?:[a-z0-9-]{0,46}[a-z0-9])?|team_[a-zA-Z0-9]+)$`
- **2026-08-06** `b8027f4efeda` — 1 info
  - api tag `vcr` added
- **2026-08-04** `0b0420c2223a` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/vercel/apis/api/changes/v2/:teamSlug/:projectSlug/:repositoryName/manifests/:reference/put.md)

---

[API](https://skmtc.dev/vercel/apis/api.md) · [All operations](https://skmtc.dev/vercel/apis/api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/vercel/api/revisions/4191ba96b0c1/schema)