Skip to main content
POST
/
assets
/
{assetId}
/
versions
/
{versionId}
/
revert
Revert to version by UUID
curl --request POST \
  --url https://versuno.ai/api/public/assets/{assetId}/versions/{versionId}/revert \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "commitDescription": "<string>"
}
'
{
  "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
​
versionId
string<uuid>
required

Body

application/json
​
commitDescription
string

Custom message. Auto-generated if omitted.

Maximum string length: 2000

Response

Newly created revert 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. 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.