Skip to main content
PATCH
Update an organization reusable block

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
name
string
Example:

"Legal disclaimer"

description
object
Example:

"Reusable footer disclaimer for proposals."

category
string
Example:

"legal"

tags
string[]
Example:
markdown
string

Replacement Extended Markdown. When provided, a new block version is published.

variables
object

Optional variables metadata for a new block version.

changeNote
string

Short changelog note used when replacement Markdown publishes a new version.

Example:

"Updated payment deadline and contact details"

status
enum<string>
Available options:
DRAFT,
ACTIVE,
ARCHIVED

Response

200 - application/json
id
string
required
orgId
string
required
name
string
required
slug
string
required
category
string
required
tags
string[]
required
status
enum<string>
required
Available options:
DRAFT,
ACTIVE,
ARCHIVED
currentVersion
number
required
createdAt
string<date-time>
required
updatedAt
string<date-time>
required
description
string | null
createdByUserId
string | null
current
object
versions
object[]