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.
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
e.g. filter[release_status][eq]=released, or filter[channel][eq]=latest.
Release fields, - for descending. Default -created_at.
Page size. Defaults to 50; larger than 500 is clamped to 500.
Rows to skip. At most 10 000.
false skips page.total.
Response
OK
Changes
No recorded changes to this operation across all 1 revision of this API.