List block children

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

{
  "object": "list",
  "results": [
    {
      "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": "divider",
      "divider": {}
    }
  ],
  "next_cursor": null,
  "has_more": false,
  "type": "block",
  "block": {},
  "request_id": "33333333-3333-4333-8333-333333333333"
}

GET

blocks

{id}

children

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

{
  "object": "list",
  "results": [
    {
      "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": "divider",
      "divider": {}
    }
  ],
  "next_cursor": null,
  "has_more": false,
  "type": "block",
  "block": {},
  "request_id": "33333333-3333-4333-8333-333333333333"
}

Reads a block’s direct children. With a document ID, returns the top-level blocks of its content. For a block with has_children: true, call again with its ID. A subpage with no card in the content doesn’t appear in the list.

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.

number

default:"100"

1 to 100.

string

next_cursor from the previous response. It’s the ID of the first block in the next set.

object[]

Block objects. See Retrieve a block.

string | null

The cursor for the next set.

boolean

true if there’s more.

string

Always block.

Read all content

Call this endpoint with the document ID, then call it again for each block with has_children: true. This sends one request for each block with children. If rate limits are a concern, use Retrieve as Markdown.

Errors

Status	`code`	Cause
400	`validation_error`	`page_size` is wrong, or `start_cursor` isn’t the ID of a child of this block.
404	`object_not_found`	The block doesn’t exist, or the integration can’t read it. Children of trashed documents and databases also return 404.

See Common rules for shared errors.

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

{
  "object": "list",
  "results": [
    {
      "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": "divider",
      "divider": {}
    }
  ],
  "next_cursor": null,
  "has_more": false,
  "type": "block",
  "block": {},
  "request_id": "33333333-3333-4333-8333-333333333333"
}

Common

Users

Search

Databases and data sources

Pages

Blocks

Comments

Read all content

Errors

​Read all content

​Errors

Read all content

Errors