Lap-Platform Notion API
API version: 2.0.0
Auth
Bearer bearer | Bearer basic
Base URL
Setup
- Set Authorization header with your Bearer token
- GET /v1/users -- verify access
- 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