> For the complete documentation index, see [llms.txt](https://actlysai.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://actlysai.gitbook.io/docs/supported-protocols-and-platforms/apps/notion.md).

# Notion

AI agents can help you search, read, and edit Notion in plain language, no messy IDs. Here’s what you can do, with examples.

### 1. Work with pages

Create, open, update, archive, and restore pages.

Examples:

* Create a new page in the database “Company OKRs” titled “Quarterly OKRs”, set 📊 as the icon, and add a paragraph “Draft goals for Q2.”
* Get details for the page “Quarterly OKRs”.
* Update the page “Quarterly OKRs”, set the “Status” property to “In Progress”, and set the icon to ✅.
* Archive the page “Meeting Notes”.
* Restore the archived page “Meeting Notes”.
* Search for pages containing “Project Plan”.

### 2. Page properties

Read a specific property on a page.

Examples:

* Retrieve the “Status” property value for the page “Quarterly OKRs”.
* Retrieve the “Owner” property for the page “Project Plan”.

### 3. Blocks

Append, read, update, or delete content blocks.

Examples:

* Append a paragraph “Next steps, finalize budget” to the page “Quarterly OKRs”.
* Get the first 50 child blocks of the page “Project Kickoff”.
* Update a paragraph in “Project Kickoff” to say “Project kickoff is confirmed for next Monday.”
* Delete a checklist block from “Project Kickoff”.

### 4. Databases

Create databases, read schemas, and run filtered queries.

Examples:

* Create a database under the page “Team Home” titled “Team Tasks” with properties, Task Name, Status with values To Do, In Progress, Done, and Due Date.
* Retrieve the schema for the database “Team Tasks”.
* Update the database “Team Tasks”, change the title to “Team Projects”, add a description “Tracking all active and completed projects”, and add a “Priority” select.
* Query the database “Team Tasks” for items where Status is “In Progress”, sort by Due Date ascending, return 20 results.

### 5. Users

List everyone in the workspace or fetch one person.

Examples:

* List all users in my workspace.
* Get details for the user named “Jane Doe”.
* Get details for me, the current authenticated user.

### 6. Comments

Discuss and review directly on pages.

Examples:

* Add a comment “We should update this section before publishing” to the page “Landing Page Draft”.
* Retrieve the first 20 comments on the page “Landing Page Draft”.
* List all comments on “Landing Page Draft”, limit 50 per page.