---
title: "Create image blob/layer upload"
method: POST
path: "/v2/{name}/blobs/uploads"
---

# Create image blob/layer upload

`POST /v2/{name}/blobs/uploads`

Create a new image blob/layer upload. With no query parameters, starts an upload session
and returns 202.
A `digest` query parameter requests a monolithic upload and returns 201 on success.
A `mount` query parameter requests a cross-repository blob mount and returns 201 or 202.

## Path parameters

- `name` string, required

## Query parameters

- `digest` string
- `mount` string

## Response `201`

created

## Other responses

- `202` — accepted
- `400` — bad request (invalid digest or upload)
- `401` — unauthorized
- `404` — not found
- `415` — unsupported media type (monolithic upload requires application/octet-stream)
- `500` — internal server error

---

[API](https://skmtc.net/project-zot/apis/open-container-initiative-distribution-specification.md) · [All operations](https://skmtc.net/project-zot/apis/open-container-initiative-distribution-specification/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/project-zot/open-container-initiative-distribution-specification/versions/62d5df709bf8/schema)