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: Bearer <token>'
[
  {
    "assetId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "assetType": "prompt",
    "versionNumber": 3,
    "assetData": {
      "title": "Customer support assistant",
      "content": "You are a friendly customer support agent...",
      "emoji": "🤖"
    },
    "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"
    }
  }
]

Authorizations

​
Authorization
string
header
default:uk_live_your_api_key_here
required

Versuno API key. Format: 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.

Example:
{
  "title": "Customer support assistant",
  "content": "You are a friendly customer support agent...",
  "emoji": "🤖"
}
​
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.