releases

List releases

Every release the caller can read, newest first. Scoped to the caller's readable workspace set the way /action-runs is, so a release in a workspace the caller holds no role on is absent rather than refused. A caller readable on more than 10,000 workspaces sees a floor rather than a refusal, and is_truncated is true: the items and page.total then cover only part of what the caller may read.

Every status is included, withdrawn among them: a shipping record that hid its own retractions would be the wrong record.

The shared list grammar: filter[field][op]= over release_id, artifact_id, kind, workspace_id, version_id, channel, version_ordinal, version_label, visibility, release_status, created_at, updated_at and released_at; sort= over the same fields — sort=-released_at for what shipped most recently, which for an auto policy's release is not what was queued most recently; limit (default 50, clamped to 500), offset (at most 10 000) and count=false to skip page.total. The migration that created this table seeded a row per version of every artifact, so an account's full history is large — a browse that only wants the recent ones should pass count=false.

get/registry/v1/releases

Request

  • Base URL: https://api.atlan.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.atlan.com/registry/v1/releases
  • Auth: HTTP bearer

Query parameters

filterstring

e.g. filter[release_status][eq]=released, or filter[channel][eq]=latest.

sortstring

Release fields, - for descending. Default -created_at.

limitinteger

Page size. Defaults to 50; larger than 500 is clamped to 500.

offsetinteger

Rows to skip. At most 10 000.

countboolean

false skips page.total.

Response

OK

is_truncatedboolean required

true when the caller's readable workspaces were cut at the lookup cap, so items and page.total are a floor rather than everything the caller may read.

Changes

No recorded changes to this operation across all 1 revision of this API.