Skip to main content
POST
Build insert payload for snapshot/reference insertion

Authorizations

Authorization
string
header
required

Short-lived, Developer-API-audience token obtained by the trusted MCP service through token exchange (mcp_at_...). Raw MCP resource tokens are rejected.

Path Parameters

blockId
string
required

Body

application/json
mode
enum<string>
default:reference
required
Available options:
snapshot,
reference
version
number

Specific version number. Omit for latest/current version.

locked
boolean
default:false

Lock reference blocks in the editor until detached.

Response

200 - application/json
mode
enum<string>
required
Available options:
snapshot,
reference
content
string[]
required

Blocks to insert for snapshot mode or one blockReference element for reference mode.

block
object
required