Skip to main content
POST
/
assets
Create an asset
curl --request POST \
  --url https://versuno.ai/api/public/assets \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "assetType": "prompt",
  "title": "Customer support assistant",
  "content": "You are a friendly customer support agent..."
}
'
{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "assetType": "prompt",
  "title": "Customer support assistant",
  "description": "Handles tier-1 support tickets",
  "content": "You are a friendly customer support agent...",
  "emoji": "🤖",
  "projectId": null,
  "teamId": null,
  "userId": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
  "createdAt": "2026-01-15T10:30:00.000Z",
  "updatedAt": "2026-01-15T10:30:00.000Z",
  "deletedAt": null
}
Send assetType, title, and content to create an asset. Nullable fields must be explicitly included — send null if you don’t have a value. The created asset is returned with its generated id and timestamps.
assetType is set at creation and cannot be changed later. Make sure you pick the right type before saving.

Authorizations

​
Authorization
string
header
default:uk_live_your_api_key_here
required

Versuno API key. Format: uk_live_...

Body

application/json
​
assetType
enum<string>
required

Type of asset. Immutable after creation.

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

"prompt"

​
title
string
required

Display name of the asset.

Example:

"Customer support assistant"

​
content
string
required

The main content body.

Example:

"You are a friendly customer support agent..."

​
description
string | null

Optional asset description

Example:

"Handles tier-1 support tickets"

​
emoji
string | null

Single emoji icon.

Example:

"🤖"

​
projectId
string<uuid> | null

Nest inside an existing project.

Example:

null

​
teamId
string<uuid> | null

Assign to a team workspace.

Example:

null

​
lastUsedAt
string<date-time> | null

Manually set the last-used timestamp.

Example:

null

Response

Created asset object.

An AI asset — a prompt, persona, context, system prompt, or skill.

​
id
string<uuid>

Unique identifier for the asset.

Example:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"

​
assetType
enum<string>

Type of AI asset. Immutable after creation.

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

"prompt"

​
title
string

Display name of the asset.

Example:

"Customer support assistant"

​
description
string | null

Short summary shown in the UI.

Example:

"Handles tier-1 support tickets"

​
content
string

The main content body of the asset.

Example:

"You are a friendly customer support agent. Help users resolve their issues quickly and professionally."

​
emoji
string | null

Single emoji icon for the asset.

Example:

"🤖"

​
projectId
string<uuid> | null

ID of the project this asset belongs to, or null if unassigned.

Example:

null

​
teamId
string<uuid> | null

ID of the team workspace this asset belongs to, or null for personal.

Example:

null

​
userId
string<uuid>

ID of the user who owns this asset.

Example:

"b2c3d4e5-f6a7-8901-bcde-f12345678901"

​
createdAt
string<date-time>

ISO 8601 timestamp when the asset was created.

Example:

"2026-01-15T10:30:00.000Z"

​
updatedAt
string<date-time>

ISO 8601 timestamp of the last update.

Example:

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

​
deletedAt
string<date-time> | null

ISO 8601 timestamp when the asset was trashed, or null if active.

Example:

null