Retrieve a block

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

{
  "object": "block",
  "id": "exampleRow01.exampleBlk01",
  "parent": {
    "type": "page_id",
    "page_id": "exampleRow01"
  },
  "created_time": "2026-01-15T02:30:00.000Z",
  "last_edited_time": "2026-01-15T03:10:00.000Z",
  "created_by": {
    "object": "user",
    "id": "11111111-1111-4111-8111-111111111111"
  },
  "last_edited_by": {
    "object": "user",
    "id": "11111111-1111-4111-8111-111111111111"
  },
  "has_children": false,
  "in_trash": false,
  "type": "paragraph",
  "paragraph": {
    "rich_text": [
      {
        "type": "text",
        "text": {
          "content": "Reviewed the January orders.",
          "link": null
        },
        "annotations": {
          "bold": false,
          "italic": false,
          "strikethrough": false,
          "underline": false,
          "code": false,
          "color": "default"
        },
        "plain_text": "Reviewed the January orders.",
        "href": null
      }
    ],
    "color": "default"
  },
  "request_id": "33333333-3333-4333-8333-333333333333"
}

{
  "object": "error",
  "status": 404,
  "code": "object_not_found",
  "message": "Could not find block with ID: exampleRow01.exampleBlk01. Make sure the relevant pages and databases are shared with your connection \"Order sync\".",
  "request_id": "33333333-3333-4333-8333-333333333333"
}

GET

blocks

{id}

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

{
  "object": "block",
  "id": "exampleRow01.exampleBlk01",
  "parent": {
    "type": "page_id",
    "page_id": "exampleRow01"
  },
  "created_time": "2026-01-15T02:30:00.000Z",
  "last_edited_time": "2026-01-15T03:10:00.000Z",
  "created_by": {
    "object": "user",
    "id": "11111111-1111-4111-8111-111111111111"
  },
  "last_edited_by": {
    "object": "user",
    "id": "11111111-1111-4111-8111-111111111111"
  },
  "has_children": false,
  "in_trash": false,
  "type": "paragraph",
  "paragraph": {
    "rich_text": [
      {
        "type": "text",
        "text": {
          "content": "Reviewed the January orders.",
          "link": null
        },
        "annotations": {
          "bold": false,
          "italic": false,
          "strikethrough": false,
          "underline": false,
          "code": false,
          "color": "default"
        },
        "plain_text": "Reviewed the January orders.",
        "href": null
      }
    ],
    "color": "default"
  },
  "request_id": "33333333-3333-4333-8333-333333333333"
}

{
  "object": "error",
  "status": 404,
  "code": "object_not_found",
  "message": "Could not find block with ID: exampleRow01.exampleBlk01. Make sure the relevant pages and databases are shared with your connection \"Order sync\".",
  "request_id": "33333333-3333-4333-8333-333333333333"
}

Reads one block. Writing isn’t available. To read children, use List block children.

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

The block ID.

Block IDs

ID	Block returned
Document ID	That document’s `child_page`. Its children are the content.
Inline or connected database ID	`child_database`, with no children.
Anything else	A block in the form `<document id>.<block address>`.

Use block IDs as you received them. Some blocks in a document nobody has opened use position-based IDs, which can change when the document is first edited.

Block object

string

The block ID.

object

One of page_id, block_id, data_source_id, or workspace.

string

The value from the block’s document.

string

The value from the block’s document.

object

The value from the block’s document.

object

The value from the block’s document.

boolean

true if it has children.

boolean

true if its document is in the trash.

string

The block type.

Block types

Group	`type`
Text	`paragraph`, `heading_1`, `heading_2`, `heading_3`, `heading_4`, `quote`, `callout`, `toggle`
Lists	`bulleted_list_item`, `numbered_list_item`, `to_do`
Code and equations	`code`, `equation`
Structure	`divider`, `table`, `table_row`, `column_list`, `column`, `tab`, `table_of_contents`, `breadcrumb`, `synced_block`
Files and links	`image`, `video`, `audio`, `pdf`, `file`, `bookmark`, `embed`, `link_to_page`
Children	`child_page`, `child_database`
No equivalent	`unsupported`, with the original type in `unsupported.block_type`

Blocks returned as unsupported include buttons, Bottari notes, files that couldn’t be signed, and cards for documents the integration can’t read (alias). Besides the rich text items used in properties, block text can include link_preview mentions.

Errors

Status	`code`	Cause
404	`object_not_found`	The block doesn’t exist, or the integration can’t read it. Deleted blocks also return 404.

See Common rules for shared errors.

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

{
  "object": "block",
  "id": "exampleRow01.exampleBlk01",
  "parent": {
    "type": "page_id",
    "page_id": "exampleRow01"
  },
  "created_time": "2026-01-15T02:30:00.000Z",
  "last_edited_time": "2026-01-15T03:10:00.000Z",
  "created_by": {
    "object": "user",
    "id": "11111111-1111-4111-8111-111111111111"
  },
  "last_edited_by": {
    "object": "user",
    "id": "11111111-1111-4111-8111-111111111111"
  },
  "has_children": false,
  "in_trash": false,
  "type": "paragraph",
  "paragraph": {
    "rich_text": [
      {
        "type": "text",
        "text": {
          "content": "Reviewed the January orders.",
          "link": null
        },
        "annotations": {
          "bold": false,
          "italic": false,
          "strikethrough": false,
          "underline": false,
          "code": false,
          "color": "default"
        },
        "plain_text": "Reviewed the January orders.",
        "href": null
      }
    ],
    "color": "default"
  },
  "request_id": "33333333-3333-4333-8333-333333333333"
}

{
  "object": "error",
  "status": 404,
  "code": "object_not_found",
  "message": "Could not find block with ID: exampleRow01.exampleBlk01. Make sure the relevant pages and databases are shared with your connection \"Order sync\".",
  "request_id": "33333333-3333-4333-8333-333333333333"
}

Common

Users

Search

Databases and data sources

Pages

Blocks

Comments

Block IDs

Block object

Block types

Errors

​Block IDs

​Block object

​Block types

​Errors

Block IDs

Block object

Block types

Errors