Skip to main content
PATCH
/
assets
/
{assetId}
/
blocks
Patch specific blocks
curl --request PATCH \
  --url https://versuno.ai/api/public/assets/{assetId}/blocks \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "contentBlocks": [
    {
      "id": "b_35effee2-0c97-463b-9a0a-8973eca1b4da",
      "content": "Only this block is updated"
    }
  ]
}
'
{
  "assetId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "updatedBlockIds": [
    "<string>"
  ],
  "content": "<string>",
  "contentBlocks": [
    {
      "id": "b_35effee2-0c97-463b-9a0a-8973eca1b4da",
      "type": "paragraph",
      "meta": {},
      "content": "This block was updated",
      "inline": [
        {}
      ],
      "children": "<array>"
    }
  ]
}

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.

Patch one or many blocks by ID. Only the provided fields are changed on each block. This endpoint only supports field updates (content, inline, meta). Structural changes like wrapping and block-type transforms are handled by POST /assets/{assetId}/blocks/operations.
This endpoint does not create a manual version checkpoint. Use POST /assets/{assetId}/versions for manual versioning.

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

Response

Patched blocks and full updated block tree.

​
assetId
string<uuid>
​
updatedBlockIds
string[]
​
content
string
​
contentBlocks
object[]