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

# Notion

> Connect Notion to your Atako agents — 13 read and 15 write actions.

Let your agents read and write your Notion workspace — search, query databases, and create or update pages, blocks and comments.

## Connection

* **Authentication**: API key (Internal integration secret (ntn\_/secret\_...)).

<Note>
  Go to notion.so/my-integrations → New integration → pick your workspace and name it. Under Capabilities enable "Read content", "Update content", "Insert content" and comment read/insert, then copy the Internal Integration Secret (starts with ntn\_ or secret\_). Finally, open each page or database the agent should access and share it via ••• → Connections → your integration.

  See [Notion's documentation](https://www.notion.so/my-integrations).
</Note>

## Read actions (13)

| Action                   | Description                                                            |
| ------------------------ | ---------------------------------------------------------------------- |
| `get_block`              | Retrieve a single block.                                               |
| `get_bot_user`           | Retrieve the integration's own bot user (verifies the token).          |
| `get_database`           | Retrieve a database object including its property schema.              |
| `get_page`               | Retrieve a page and its property values.                               |
| `get_page_property_item` | Retrieve a single property item of a page (paginated for long values). |
| `get_user`               | Retrieve a user by ID.                                                 |
| `list_block_children`    | List the child blocks of a block or page (use to read page content).   |
| `list_comments`          | List open comments on a page or block.                                 |
| `list_users`             | List all users in the workspace (members and bots).                    |
| `query_database`         | Query a database — list its pages with optional filters and sorts.     |
| `search`                 | Search all pages and databases shared with the integration by title.   |
| `search_databases`       | Search databases by title (results filtered to databases only).        |
| `search_pages`           | Search pages by title (results filtered to pages only).                |

## Write actions (15)

| Action                  | Description                                                                            |
| ----------------------- | -------------------------------------------------------------------------------------- |
| `append_block_children` | Append raw block objects as children of a block or page.                               |
| `append_bulleted_list`  | Append a bulleted list (one item per string) to a page or block.                       |
| `append_callout`        | Append a callout block (highlighted note with optional emoji icon) to a page or block. |
| `append_code_block`     | Append a code block with syntax highlighting to a page or block.                       |
| `append_paragraph`      | Append a plain-text paragraph to a page or block.                                      |
| `append_to_do`          | Append to-do checkbox items (one per string) to a page or block.                       |
| `archive_page`          | Archive a page (move it to trash).                                                     |
| `create_comment`        | Add a comment to a page or reply to an existing discussion thread.                     |
| `create_database`       | Create a database as a child of a page, with a property schema.                        |
| `create_page`           | Create a page under a parent page or as an entry in a database.                        |
| `delete_block`          | Delete (archive) a block.                                                              |
| `restore_page`          | Restore an archived page from trash.                                                   |
| `update_block`          | Update the content of a block (pass the block-type object) or its archived state.      |
| `update_database`       | Update the title, description or property schema of a database.                        |
| `update_page`           | Update the properties, icon, cover or archived state of a page.                        |

## Permissions

Every action above must be explicitly granted to an agent before it can be used. See [Permissions](/integrations/permissions) for the grant model and [Security](/integrations/security) for how credentials are protected.