Skip to main content
GET
/
assets
/
{assetId}
/
versions
List version history
curl --request GET \
  --url https://versuno.ai/api/public/assets/{assetId}/versions \
  --header 'Authorization: <api-key>'
[
  {
    "assetId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "assetType": "prompt",
    "versionNumber": 3,
    "assetData": {
      "title": "SKILL",
      "content": "fdasfsd\n\nfdsafdsa",
      "description": null,
      "emoji": null,
      "tags": [],
      "files": [],
      "is_public": false,
      "block_ids": [
        "b_015729a2-f530-40b0-aa65-6f3efadc967e",
        "b_55000bce-0e51-45d6-bd64-3962ec8b948b"
      ],
      "content_blocks": [
        {
          "id": "b_015729a2-f530-40b0-aa65-6f3efadc967e",
          "type": "paragraph",
          "meta": {},
          "content": "fdasfsd"
        },
        {
          "id": "b_55000bce-0e51-45d6-bd64-3962ec8b948b",
          "type": "paragraph",
          "meta": {},
          "content": "fdsafdsa"
        }
      ]
    },
    "userId": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
    "id": "d4e5f6a7-b8c9-0123-def0-234567890123",
    "commitDescription": "Updated tone to be more empathetic",
    "createdAt": "2026-01-20T14:45:00.000Z",
    "user": {
      "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "fullName": "Alex Johnson",
      "username": "alexj",
      "avatarUrl": "https://versuno.ai/avatars/alexj.png"
    }
  }
]

Documentation Index

Fetch the complete documentation index at: https://docs.versuno.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
default:Bearer uk_live_your_api_key_here
required

Versuno API key. Must be prefixed with Bearer. Format: Bearer uk_live_...

Path Parameters

​
assetId
string<uuid>
required

Query Parameters

​
limit
integer
default:50

Number of versions to return (1–200, default 50).

Required range: 1 <= x <= 200

Response

Array of version objects.

​
assetId
string<uuid>
required

ID of the asset this version belongs to.

Example:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"

​
assetType
enum<string>
required

Type of the parent asset.

Available options:
prompt,
persona,
context,
system_prompt,
skill
Example:

"prompt"

​
versionNumber
integer
required

Monotonically increasing version number within the asset.

Example:

3

​
assetData
object
required

Full snapshot of the asset state at the time this version was saved. Returned exactly as stored (no key normalization).

Example:
{
  "title": "SKILL",
  "content": "fdasfsd\n\nfdsafdsa",
  "description": null,
  "emoji": null,
  "tags": [],
  "files": [],
  "is_public": false,
  "block_ids": [
    "b_015729a2-f530-40b0-aa65-6f3efadc967e",
    "b_55000bce-0e51-45d6-bd64-3962ec8b948b"
  ],
  "content_blocks": [
    {
      "id": "b_015729a2-f530-40b0-aa65-6f3efadc967e",
      "type": "paragraph",
      "meta": {},
      "content": "fdasfsd"
    },
    {
      "id": "b_55000bce-0e51-45d6-bd64-3962ec8b948b",
      "type": "paragraph",
      "meta": {},
      "content": "fdsafdsa"
    }
  ]
}
​
userId
string<uuid>
required

ID of the user who created this version.

Example:

"b2c3d4e5-f6a7-8901-bcde-f12345678901"

​
id
string<uuid>

Unique identifier for this version.

Example:

"d4e5f6a7-b8c9-0123-def0-234567890123"

​
commitDescription
string | null

Optional message describing what changed in this version.

Example:

"Updated tone to be more empathetic"

​
createdAt
string<date-time>

ISO 8601 timestamp when this version was saved.

Example:

"2026-01-20T14:45:00.000Z"

​
user
object

Author profile.