Skip to main content
POST
Create a block
Create a new block by providing a block payload. Optionally set parentId and position.

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

assetType
enum<string>

Optional type guard. If supplied, it must match the asset's actual type.

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

Body

application/json
block
object
required
parentId
string | null

Target parent block ID. Null means root level.

position
integer

Insert position among siblings.

Required range: x >= 0

Response

Block created.

assetId
string<uuid>
block
object

A single editor block in an asset's structured content tree.

content
string
contentBlocks
object[]