# Notion API

> Notion API skill. Use when working with Notion for users, search, blocks. Covers 22 endpoints.

- Skill: `lap-platform/notion-api` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add lap-platform/notion-api`
- Raw SKILL.md: https://api.skillmd.com/api/skills/lap-platform/notion-api/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: Lap-Platform (https://skillmd.com/u/lap-platform)
- Updated: 2026-08-19
- Page: https://skillmd.com/skills/lap-platform/notion-api

---


# Notion API
API version: 2.0.0

## Auth
Bearer bearer | Bearer basic

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

## Setup
1. Set Authorization header with your Bearer token
2. GET /v1/users -- verify access
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

## Response Tips
- Check response schemas in references/api-spec.lap for field details
- List endpoints may support pagination; check for limit, offset, or cursor params
- Create/update endpoints typically return the created/updated object

## 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)