---
name: notion-api
description: "Notion API skill. Use when working with Notion for users, search, blocks. Covers 22 endpoints."
version: 1.0.0
generator: lapsh
---

# Notion API
API version: 2.0.0

## Auth
Bearer bearer | Bearer basic

## Base URL
https://api.notion.com

## Setup
1. Set Authorization header with Bearer token
2. GET /v1/users -- list all users
3. POST /v1/search -- create first search

## Endpoints
22 endpoints across 7 groups. See references/api-spec.lap for full details.

### Users
| Method | Path | Description |
|--------|------|-------------|
| GET | /v1/users/{user_id} | Retrieve a user |
| GET | /v1/users | List all users |
| GET | /v1/users/me | Retrieve your token's bot user |

### Search
| Method | Path | Description |
|--------|------|-------------|
| POST | /v1/search | Search by title |

### Blocks
| Method | Path | Description |
|--------|------|-------------|
| GET | /v1/blocks/{block_id}/children | Retrieve block children |
| PATCH | /v1/blocks/{block_id}/children | Append block children |
| GET | /v1/blocks/{block_id} | Retrieve a block |
| PATCH | /v1/blocks/{block_id} | Update a block |
| DELETE | /v1/blocks/{block_id} | Delete a block |

### Pages
| Method | Path | Description |
|--------|------|-------------|
| GET | /v1/pages/{page_id} | Retrieve a page |
| PATCH | /v1/pages/{page_id} | Update page properties |
| POST | /v1/pages | Create a page |
| GET | /v1/pages/{page_id}/properties/{property_id} | Retrieve a page property item |
| POST | /v1/pages/{page_id}/move | Move a page |

### Comments
| Method | Path | Description |
|--------|------|-------------|
| GET | /v1/comments | Retrieve comments |
| POST | /v1/comments | Create comment |

### Data_sources
| Method | Path | Description |
|--------|------|-------------|
| POST | /v1/data_sources/{data_source_id}/query | Query a data source |
| GET | /v1/data_sources/{data_source_id} | Retrieve a data source |
| PATCH | /v1/data_sources/{data_source_id} | Update a data source |
| POST | /v1/data_sources | Create a data source |
| GET | /v1/data_sources/{data_source_id}/templates | List templates in a data source |

### Databases
| Method | Path | Description |
|--------|------|-------------|
| GET | /v1/databases/{database_id} | Retrieve a database |

## Common Questions
Match user requests to endpoints in references/api-spec.lap. Key patterns:
- "Get user details?" -> GET /v1/users/{user_id}
- "List all users?" -> GET /v1/users
- "List all me?" -> GET /v1/users/me
- "Create a search?" -> POST /v1/search
- "List all children?" -> GET /v1/blocks/{block_id}/children
- "Get block details?" -> GET /v1/blocks/{block_id}
- "Partially update a block?" -> PATCH /v1/blocks/{block_id}
- "Delete a block?" -> DELETE /v1/blocks/{block_id}
- "Get page details?" -> GET /v1/pages/{page_id}
- "Partially update a page?" -> PATCH /v1/pages/{page_id}
- "Create a page?" -> POST /v1/pages
- "Get property details?" -> GET /v1/pages/{page_id}/properties/{property_id}
- "List all comments?" -> GET /v1/comments
- "Create a comment?" -> POST /v1/comments
- "Create a query?" -> POST /v1/data_sources/{data_source_id}/query
- "Get data_source details?" -> GET /v1/data_sources/{data_source_id}
- "Partially update a data_source?" -> PATCH /v1/data_sources/{data_source_id}
- "Create a data_source?" -> POST /v1/data_sources
- "List all templates?" -> GET /v1/data_sources/{data_source_id}/templates
- "Get database details?" -> GET /v1/databases/{database_id}
- "Create a move?" -> POST /v1/pages/{page_id}/move
- "How to authenticate?" -> See Auth section above

## Response Tips
- Check response schemas in references/api-spec.lap for field details
- Paginated endpoints accept limit/offset or cursor parameters
- Create/update endpoints return the modified resource on success
- Error responses include status codes and descriptions in the spec

## References
- Full spec: See references/api-spec.lap for complete endpoint details, parameter tables, and response schemas

> Generated from the official API spec by [LAP](https://lap.sh)