Skip to main content
POST
/
assets
/
{assetId}
/
versions
Create a version
curl --request POST \
  --url https://versuno.ai/api/public/assets/{assetId}/versions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "assetData": {}
}
'
{
  "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

Body

application/json
​
assetData
object
required

Full snapshot of the asset state to save.

​
commitDescription
string
Maximum string length: 2000

Response

Newly created version object.

A full-snapshot version checkpoint of an asset.

​
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.