Delete image manifest Run in API Explorer

DELETE /v2/{name}/manifests/{reference}

Delete an image manifest from a repository by digest.

Only untagged or unreferenced manifests can be deleted. If the manifest is still referenced by a tag or another image, the registry will return 403 Forbidden.

This operation requires delete access to the repository.

Headers

  • Authorization string Required

    Bearer token with delete access

Path parameters

  • name string Required

    Name of the repository

  • reference string Required

    Digest of the manifest to delete (e.g., sha256:...)

Responses

  • 202

    Manifest deleted successfully. No content returned.

  • 401

    Authentication required.

  • 403

    Access denied. The manifest may still be referenced.

  • 404

    Manifest or repository not found.

  • 405

    Only digest-based deletion is allowed.

  • 429

    Too many requests.

DELETE /v2/{name}/manifests/{reference} 
# DELETE a manifest by digest
curl -X DELETE \
  -H "Authorization: Bearer $TOKEN" \
  https://registry-1.docker.io/v2/yourusername/helloworld/manifests/sha256:abc123def456...

curl \
 --request DELETE 'https://registry-1.docker.io/v2/yourusername/helloworld/manifests/sha256:abc123def456...' \
 --header "Authorization: string"