Retrieve content as Markdown

curl https://api.bottari.ai/v1/pages/exampleRow01/markdown \
  -H "Authorization: Bearer $BOTTARI_TOKEN" \
  -H "Bottari-Version: 2026-03-11"

{
  "object": "page_markdown",
  "id": "exampleRow01",
  "markdown": "# Progress\n\nReviewed the <b>January</b> orders.",
  "truncated": false,
  "unknown_block_ids": [],
  "request_id": "33333333-3333-4333-8333-333333333333"
}

{
  "object": "error",
  "status": 400,
  "code": "validation_error",
  "message": "markdown_version should be `v2`.",
  "request_id": "33333333-3333-4333-8333-333333333333"
}

GET

pages

{id}

markdown

curl https://api.bottari.ai/v1/pages/exampleRow01/markdown \
  -H "Authorization: Bearer $BOTTARI_TOKEN" \
  -H "Bottari-Version: 2026-03-11"

{
  "object": "page_markdown",
  "id": "exampleRow01",
  "markdown": "# Progress\n\nReviewed the <b>January</b> orders.",
  "truncated": false,
  "unknown_block_ids": [],
  "request_id": "33333333-3333-4333-8333-333333333333"
}

{
  "object": "error",
  "status": 400,
  "code": "validation_error",
  "message": "markdown_version should be `v2`.",
  "request_id": "33333333-3333-4333-8333-333333333333"
}

Reads content as Markdown. Pass a document ID for all its content, or a block ID to start from that block. Writing isn’t available.

string

required

Bearer <token>. See Tokens.

string

Optional. Only 2026-03-11 is accepted. Without it, the current version is used. A different value returns 400.

string

required

A document ID or block ID.

string

default:"v2"

Only v2 is accepted. v1 returns 400.

boolean

Accepts true or false but doesn’t affect the result. Bottari notes appear as unknown.

string

Always page_markdown.

string

The ID you requested.

string

The content.

boolean

true if at least one block couldn’t be written as Markdown.

string[]

IDs of those blocks, up to 100. They match block API IDs.

A block that can’t be written appears as <unknown url="..." alt="..." />. A block with no Markdown form can be read again by its ID. A block hidden by permissions returns 404. An uploaded file block appears with its signed URL. Trashed documents can also be read. Trashed inline databases are left out of the content.

Errors

Status	`code`	Cause
400	`validation_error`	`markdown_version` isn’t `v2`, or `include_transcript` isn’t a boolean.
404	`object_not_found`	The document or block doesn’t exist, or the integration can’t read it.

See Common rules for shared errors.

curl https://api.bottari.ai/v1/pages/exampleRow01/markdown \
  -H "Authorization: Bearer $BOTTARI_TOKEN" \
  -H "Bottari-Version: 2026-03-11"

{
  "object": "page_markdown",
  "id": "exampleRow01",
  "markdown": "# Progress\n\nReviewed the <b>January</b> orders.",
  "truncated": false,
  "unknown_block_ids": [],
  "request_id": "33333333-3333-4333-8333-333333333333"
}

{
  "object": "error",
  "status": 400,
  "code": "validation_error",
  "message": "markdown_version should be `v2`.",
  "request_id": "33333333-3333-4333-8333-333333333333"
}

Common

Users

Search

Databases and data sources

Pages

Blocks

Comments

Errors

​Errors

Errors