Append one or more child blocks to a parent block (or page). children is an array of block objects ({type, data}). Returns the list of created blocks.

Convert a Markdown string into Buildin blocks and append them to the given page/block. Supports headings (# ## ###), lists, task lists, code fences, blockquotes, dividers, and inline bold/italic/code/link. Returns the Buildin response with the created block ids.

Convenience wrapper over update_page: sets archived=true by default (pass archived=false to restore). Buildin.ai does not expose hard-delete for pages.

Create a new Buildin.ai database under a page parent. Must include at least one property of type 'title'. Set is_inline=true for inline databases.

Create a new page in Buildin.ai. The parent may be a page_id, database_id, space_id, or block_id. When parent is a database, properties must match the database schema. Returns the created page object.

Hard-delete a block by ID (DELETE /v1/blocks/{block_id}). This is NOT the same as archiving a page — it's a permanent removal.

Retrieve a single block object by ID. Does not include children.

List immediate children of a block (or page) with pagination. Use this instead of scraping a page to render its contents.

Retrieve a Buildin.ai database by id, including its property schema.

Return information about the bot that owns the current API token (GET /v1/users/me). Use this to verify authentication is working.

Retrieve a Buildin.ai page by its id. Returns the page object including properties, icon, cover, parent and url.

List top-level children blocks of a page using GET /v1/blocks/{page_id}/children. Returns a paginated list with next_cursor and has_more.

Fetch every child block of a page (walks pagination, follows has_children) and render the result as Markdown. Useful for quickly summarising or ingesting a page.

Insert new blocks after a specific child block within a parent. Since the Buildin.ai API only supports appending to the end, this works by: 1) deep-cloning all blocks after the insertion point, 2) deleting them, 3) appending the new blocks, 4) re-appending the cloned blocks. WARNING: block IDs of re-created blocks will change. This is NOT atomic — if interrupted mid-operation, blocks may be lost. Use with caution.

Query rows (pages) of a Buildin.ai database with optional filter and sort. Returns a paginated list; use next_cursor / has_more to continue.

Search across all pages the bot has access to. Returns a paginated list of page objects. query is free-form; empty string returns recently-updated pages.

Run /v1/search and, for each hit that is a page, fetch its full content as Markdown. Returns an array of { id, title, url, markdown }. Limit defaults to 3 to stay within rate limits.

Update a block's content or state. For text blocks, pass data: { rich_text: [...] }. To toggle a to_do, pass data: { checked: true }. To archive, pass archived: true.

Update a database's title, icon, cover, properties schema, or archive flag. Only fields you pass are modified. To remove a property, set its value to null.

Update a Buildin.ai page: change properties, icon, cover, or archive/unarchive it. Only the fields you pass are modified. Pass archived=true to soft-delete.