Skip to main content
GET
by artifactId

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

artifactId
string
required

The artifact whose versions to list. Unset searches the versions of every artifact in the caller's organization. A named artifact lists its versions even when it is archived.

Query Parameters

pageSize
integer<int64>

Defaults to 50; values above 200 are treated as 200.

pageToken
string

From a previous response's next_page_token. Offset tokens from before this field took cursors are rejected (InvalidArgument).

filter
string

A Common Expression Language (CEL) filter string with the ListArtifacts fields, evaluated against each version instead of the latest: title, version, file_name, file_type, version_created_date, metadata, links, runs, assets, and canvases describe the version, and the artifact fields describe its container. GetArtifactVersionFilterFields returns the fields. With artifact_id unset, versions of archived artifacts are excluded unless the query says otherwise, as in ListArtifacts.

orderBy
string

A comma-separated AIP-132 ordering string over created_date (when the version was written), version, and title. Fields sort ascending by default and support a desc suffix. The default is created_date descending.

Response

A successful response.

versions
object[]
read-only
nextPageToken
string
read-only