> ## Documentation Index
> Fetch the complete documentation index at: https://developers.bottari.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Retrieve content as Markdown

> Read a document's or block's content as Markdown.

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.

**Authorization** `string` *required*

`Bearer <token>`. See [Tokens](https://developers.bottari.ai/auth/tokens.md).

**Bottari-Version** `string`

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

**id** `string` *required*

A document ID or block ID.

**markdown\_version** `string` (default: v2)

Only `v2` is accepted. `v1` returns 400.

**object** `string`

Always `page_markdown`.

**id** `string`

The ID you requested.

**markdown** `string`

The content.

**truncated** `boolean`

`true` if at least one block couldn't be converted to Markdown.

**unknown\_block\_ids** `string[]`

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

A block that can't be converted 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`. |
| 404 | `object_not_found` | The document or block doesn't exist, or the integration can't read it. |

See [Common rules](https://developers.bottari.ai/api-reference/overview.md#errors) for shared errors.

```bash curl theme={null}
curl https://api.bottari.ai/v1/pages/exampleRow01/markdown \
  -H "Authorization: Bearer $BOTTARI_TOKEN" \
  -H "Bottari-Version: 2026-03-11"
```

```json 200 theme={null}
{
  "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"
}
```

```json 400 theme={null}
{
  "object": "error",
  "status": 400,
  "code": "validation_error",
  "message": "markdown_version \"v1\" is not supported by this server. Use markdown_version=v2 or omit it.",
  "request_id": "33333333-3333-4333-8333-333333333333"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.