Skip to main content
GET
List image tags
Use this endpoint to retrieve versions separately from image repository summaries. The default sort uses tag names, so the first item isn’t necessarily the newest version. Follow the pagination cursor while pagination.has_more is true. Filter by exact name or case-sensitive prefix q, but don’t combine them. Use a returned tag to select a version.

Authorizations

Authorization
string
header
required

Send Authorization: Bearer <api_key>. The legacy Authorization: Api-Key <api_key> scheme is also accepted.

Headers

X-Team-Id
string

Optional team ID. Must match the team_id query parameter when both are supplied. If neither selector is supplied, defaults to the caller's only accessible team. Callers with multiple accessible teams must select a team. Requests without access to any team are forbidden.

Minimum string length: 1

Path Parameters

image_name
string
required

Image repository name.

Minimum string length: 1
Example:

"base-image"

Query Parameters

team_id
string

Optional team ID. Must match X-Team-Id when both are supplied. If neither selector is supplied, defaults to the caller's only accessible team. Callers with multiple accessible teams must select a team. Requests without access to any team are forbidden.

Minimum string length: 1
cursor
string

Opaque cursor from the previous page; omit for the first page.

Example:

"eyJ2IjoxLCJsYXN0X2tleSI6ImJhc2V0ZW4tYXBpLXJldmlldy0wOTE2Iiwic29ydCI6ImRlc2MifQ"

limit
integer
default:20

Maximum number of items to return.

Required range: 1 <= x <= 100
Example:

20

sort
string
default:name:asc

Sort by tag name: name:asc or name:desc. Keep the same sort when following a cursor.

q
string

Case-sensitive tag name prefix. Cannot be combined with name. Forces ascending name order.

name
string

Exact tag name. Cannot be combined with q. Forces ascending name order.

Response

Successful operation.

One page of image tags.

items
object[]
required
pagination
object
required

Cursor pagination information. The cursor is present only when another page is available.

Example: