Cancel blob upload Run in API Explorer

DELETE /v2/{name}/blobs/uploads/{uuid}

Cancel an in-progress blob upload session.

This operation discards any data that has been uploaded and invalidates the upload session.

Use this when:

  • An upload fails or is aborted mid-process
  • The client wants to clean up unused upload sessions

After cancellation, the UUID is no longer valid and a new POST must be issued to restart the upload.

Headers

  • Authorization string Required

Path parameters

  • name string Required

    Name of the repository

  • uuid string Required

    Upload session UUID

Responses

  • 204

    Upload session cancelled successfully. No body is returned.

    Hide headers attribute Show headers attribute
    • Content-Length integer

      Always zero

  • 401

    Authentication required

  • 403

    Access denied

  • 404

    Upload session not found

  • 429

    Too many requests

DELETE /v2/{name}/blobs/uploads/{uuid} 
# DELETE – cancel an upload session
curl -X DELETE \
  -H "Authorization: Bearer $TOKEN" \
  https://registry-1.docker.io/v2/library/ubuntu/blobs/uploads/abc123`

curl \
 --request DELETE 'https://registry-1.docker.io/v2/library/ubuntu/blobs/uploads/abc123' \
 --header "Authorization: Bearer eyJhbGciOi..."