Skip to main content
POST
Create 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.

Body

application/json
name
string
required
Example:

"Legal disclaimer"

markdown
string
required

Extended Markdown content for this reusable block version.

Example:

"## Liability\n\nThis proposal is valid for 30 days."

orgId
string

Organization that owns the block. Defaults to the current user primary organization.

slug
string
Example:

"legal-disclaimer"

description
string
Example:

"Reusable footer disclaimer for proposals."

category
string
Example:

"legal"

tags
string[]
Example:
variables
object

Optional variables metadata used by this block.

changeNote
string

Short changelog note for the initial version.

Example:

"Initial approved disclaimer"

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

Response

201 - 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[]