Skip to main content
POST
Add a block

Authorizations

Authorization
string
header
required

A workspace API key: Authorization: Bearer osk_...

Headers

Idempotency-Key
string
required

8–200 letters, digits, ., _, : or -. Retry with the same key and exact same body to get the original response.

Required string length: 8 - 200
If-Match
string
required

The current revision in quotes, from the resource's ETag. Missing returns 428; out of date returns 412.

Example:

"\"a1b2c3\""

Path Parameters

page
string<uuid>
required

Page ID.

Body

application/json
type
string
required

A block type from the catalogue.

Example:

"link"

enabled
boolean
content
object

Fields for this block type. See write_schema in the catalogue.

Example:

Response

201 - application/json

Created

data
object
page_revision
string

The page's new revision.