Skip to content

Fetch artifact metadata (no body)

HEAD
/v1/artifacts/{blobId}
curl --request HEAD \
--url https://example.com/v1/artifacts/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0 \
--header 'Authorization: Bearer <token>'

Same headers as GET, empty body. 200 when the blob exists, 404 when unknown. The response headers are the authoritative payload.

blobId
required
string format: uuid

Metadata headers only.

Missing / malformed / expired / revoked bearer token.

Media typeapplication/json
object
error
required
object
code
required

Stable machine-readable discriminant. Values match domain error codes (see docs/API-ROUTE-CONVENTIONS.md §4.3).

string
message
required
string
details

Optional, kind-specific.

object
key
additional properties
any
requestId
required

Server-assigned request id; also echoed via X-Request-Id header.

string
Examplegenerated
{
"error": {
"code": "example",
"message": "example",
"details": {},
"requestId": "example"
}
}

No blob with that id under this tenant.