---
title: "List published versions"
method: GET
path: "/v1/artifacts/{id}/versions"
tags: ["Artifacts"]
---

# List published versions

`GET /v1/artifacts/{id}/versions`

## Request

- Base URL: `https://shareout.site`
- URL: `https://shareout.site/v1/artifacts/{id}/versions`
- Auth: HTTP bearer

The 50 newest published versions, newest first, with who published each one, how (`source`), its change note (`message` / `message_source`), the size of its entrypoint, how many comment threads were written on it and who approved it. `live_version_id` is the version production serves. Viewer or above.

## Response `200`

Versions

- object
  - `versions` VersionSummary[]
    - `id` string
    - `version_no` integer
    - `entrypoint` string
    - `created_at` string, date-time
    - `source` 'api' | 'agent' | 'editor' | 'restore' | 'null', nullable: How the version came to be; null on versions written before it was recorded.
    - `message` string, nullable: Change note.
    - `message_source` 'author' | 'ai' | 'null', nullable: `author` when the publisher wrote it, `ai` when generated after publish (may appear a few seconds later).
    - `created_by_email` string, nullable
    - `created_by_name` string, nullable
    - `restored_from_version_no` integer, nullable
    - `size_bytes` integer, nullable: Size of the entrypoint file.
    - `comment_count` integer: Comment threads written while this version was live.
    - `approvals` object[]
      - `name` string, nullable
      - `email` string, nullable
      - `created_at` string, date-time
  - `live_version_id` string, nullable

## Other responses

- `403`: Access denied
- `404`: Resource not found

## Changes

- **2026-10-16** `924c2aeaed12`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/shareout/apis/shareout-rest-api/changes/v1/artifacts/:id/versions/get.md)

---

[API](https://skmtc.dev/shareout/apis/shareout-rest-api.md) - [All operations](https://skmtc.dev/shareout/apis/shareout-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/shareout/apis/shareout-rest-api/revisions/1e3f7fd34f6d?raw)