Skip to main content
POST
Apply block operations
Use this endpoint for structural transforms that rewrite the block tree.

Supported operations

Only one operation is supported: turn_into. Supported turnInto values:
  • paragraph
  • heading1, heading2, heading3
  • codeBlock
  • quote
  • toggleH1, toggleH2, toggleH3, toggle
  • callout
  • bulletList, orderedList, taskList
Use PATCH /assets/{assetId}/blocks for field updates only (content, inline, meta).

Code examples

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
operations
object[]
required
Minimum array length: 1

Response

Operations applied and full updated block tree returned.

assetId
string<uuid>
appliedOperations
object[]
contentBlocks
object[]