v51

latestOpenAPI 3.0.3raw.githubusercontent.com2026-08-01140309549.5 KB
oci

Upload a chunk of data

Appends a chunk of data to an in-progress upload session. This is the recommended approach for large blobs, as each chunk is stored immediately rather than buffering the entire blob in memory.

Clients can call this endpoint multiple times to upload a blob in pieces, then call PUT /v2/{name}/blobs/uploads/{session_id}?digest=... to complete the upload.

The Content-Range header is optional but recommended - if provided, the server validates that the chunk starts at the expected offset.

patch/v2/{name}/blobs/{ref}/{session_id}

Path parameters

namestring required

Project resource ID (UUID or slug)

refstring required

Must be "uploads" for upload operations

session_idstring required

Upload session ID