---
title: "List Versions"
method: GET
path: "/api/v1/artifacts/{artifact_id}/versions"
tags: ["Artifact"]
---

# List Versions

`GET /api/v1/artifacts/{artifact_id}/versions`

## Request

- Base URL: `https://example.conductor.one`
- URL: `https://example.conductor.one/api/v1/artifacts/{artifact_id}/versions`
- Auth: HTTP bearer and OAuth 2
  - Client credentials
  - Token URL: `/auth/v1/token`

ListVersions returns authorized history in descending numeric version order.
 Owners can inspect PENDING and FAILED; Readers see only eligible READY versions.

## Path parameters

- `artifact_id` string, required: Identifier of the Artifact whose publication history is requested.

## Query parameters

- `page_size` integer: Maximum number of results per page; zero selects the service default, 20.
- `page_token` string: Sealed continuation token from a previous page for this Artifact.

## Response `200`

ArtifactServiceListVersionsResponse contains currently authorized history.
 Discovery is eventual; use GetVersion for canonical publication status.

- C1ApiArtifactV1ArtifactServiceListVersionsResponse: ArtifactServiceListVersionsResponse contains currently authorized history. Discovery is eventual; use GetVersion for canonical publication status.
  - `list` C1ApiArtifactV1ArtifactVersion[], nullable: Authorized versions in descending numeric order, without duplicates.
    - `artifactId` string: Identifier of the Artifact that owns this version.
    - `createdAt` string, date-time, nullable
    - `error` string: Safe failure summary, populated only for FAILED; never source text, secrets or detailed tool/backend errors. Consumers must enforce this condition.
    - `expectedPublishedVersionNumericId` string, int64: Exact publication pointer expected at admission; zero means unpublished. This expectation is not proof that publication succeeded.
    - `numericId` string, int64: Exact positive version number within this Artifact, displayed as v40. Gaps are allowed; JS clients use strings to preserve the full int64 range.
    - `state` 'ARTIFACT_VERSION_STATE_UNSPECIFIED' | 'ARTIFACT_VERSION_STATE_PENDING' | 'ARTIFACT_VERSION_STATE_READY' | 'ARTIFACT_VERSION_STATE_FAILED': Publication outcome. PENDING and FAILED are visible only to current Owners.
    - `viewerUrl` string: Server-generated pinned viewer link, not a download capability. Only an eligible READY version can be opened, with current grants checked each time.
  - `nextPageToken` string: Sealed continuation token, empty when scanning is complete. A short or empty page may continue; no raw candidate or denied counts are returned.

## Changes

- **2026-10-06** `918a4e749f56`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/conductorone/apis/c1-api/changes/api/v1/artifacts/:artifact_id/versions/get.md)

---

[API](https://skmtc.dev/conductorone/apis/c1-api.md) - [All operations](https://skmtc.dev/conductorone/apis/c1-api/llms.txt) - [OpenAPI document](https://skmtc.dev/conductorone/apis/c1-api/revisions/fe943bedf41b?raw)