Skip to main content
GET
Get an image that documents name

Authorizations

Authorization
string
header
required

An organization API key. Keys carry a role (read_write or read_only) and may be restricted to a namespace prefix such as acme/*, or to one namespace such as acme/prod/tenant_1. A prefix matches on a / boundary: acme/prod/tenant_1* covers acme/prod/tenant_1 and everything under acme/prod/tenant_1/, never acme/prod/tenant_12.

Path Parameters

ns
string
required

The namespace name, with any / sent as %2F. Up to 256 bytes. / separates levels of the hierarchy, as in acme/prod/tenant_123. Never exactly . or .., which a URL path can't carry.

Required string length: 1 - 256
Pattern: ^(?!\.\.?$)[A-Za-z0-9._:/-]+$
digest
string
required

The image's digest, as its reference's $image holds it. The colon may be sent as is or as %3A. An image's digest, sha256: and 64 lowercase hex digits. Two images with the same digest are the same bytes.

Pattern: ^sha256:[0-9a-f]{64}$

Response

The image, as image/png, image/jpeg or image/webp.

The response is of type file.