List Versions
Versions
List Versions
GET /v0/artifacts//versions — List all versions of an artifact, newest first
GET
List Versions
List all versions of an artifact in reverse chronological order (newest first). This endpoint is publicly accessible — no authentication required.
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
publicId | string | Yes | The public ID of the artifact |
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
limit | integer | No | Maximum number of versions to return. Default 50, max 200 |
Example Request
Example Response
Response Fields
| Field | Type | Description |
|---|---|---|
versions | array | List of version objects, newest first |
versions[].vid | string | Unique version ID |
versions[].versionNumber | integer | Sequential version number, starting at 1 |
versions[].title | string | Title of this version |
versions[].size | integer | Size of the version content in bytes |
versions[].createdAt | string | ISO 8601 timestamp of when this version was created |
Error Codes
| Error | Description |
|---|---|
ARTIFACT_NOT_FOUND | No artifact exists with the given publicId |