Documentation Index Fetch the complete documentation index at: https://lava.so/docs/llms.txt
Use this file to discover all available pages before exploring further.
Workspace and knowledge management API for searching, creating, and updating pages, databases, and blocks in Notion. Best for workflows that need to read or write structured content — project boards, wikis, meeting notes, and knowledge bases. Unlike Google Workspace (document-centric), Notion’s API exposes a database-like structure where pages have typed properties.
6 example endpoints available through Lava’s AI Gateway. See the Notion API docs for full documentation.
This provider requires your own credentials — connect your API key or OAuth account before use.
Endpoints Search pages and databases POST https://api.notion.com/v1/search — Freeconst data = await lava . gateway ( 'https://api.notion.com/v1/search' , { body: { "query" : "your search term" } });
curl -X POST "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.notion.com%2Fv1%2Fsearch" \ -H "Authorization: Bearer $LAVA_SECRET_KEY " \ -H "Content-Type: application/json" \ -d '{"query":"your search term"}'
Query a database POST https://api.notion.com/v1/databases/{database_id}/query — Freeconst data = await lava . gateway ( 'https://api.notion.com/v1/databases/{database_id}/query' , { body: {} });
curl -X POST "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.notion.com%2Fv1%2Fdatabases%2F%7Bdatabase_id%7D%2Fquery" \ -H "Authorization: Bearer $LAVA_SECRET_KEY " \ -H "Content-Type: application/json" \ -d '{}'
Retrieve a page GET https://api.notion.com/v1/pages/{page_id} — Freeconst data = await lava . gateway ( 'https://api.notion.com/v1/pages/{page_id}' , { method: 'GET' });
curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.notion.com%2Fv1%2Fpages%2F%7Bpage_id%7D" \ -H "Authorization: Bearer $LAVA_SECRET_KEY "
Create a page POST https://api.notion.com/v1/pages — Freeconst data = await lava . gateway ( 'https://api.notion.com/v1/pages' , { body: { "parent" : { "database_id" : "..." }, "properties" : { "Name" : { "title" : [ { "text" : { "content" : "New page" } } ] } } }, });
curl -X POST "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.notion.com%2Fv1%2Fpages" \ -H "Authorization: Bearer $LAVA_SECRET_KEY " \ -H "Content-Type: application/json" \ -d '{"parent":{"database_id":"..."},"properties":{"Name":{"title":[{"text":{"content":"New page"}}]}}}'
Update page properties PATCH https://api.notion.com/v1/pages/{page_id} — Freeconst data = await lava . gateway ( 'https://api.notion.com/v1/pages/{page_id}' , { method: 'PATCH' , body: { "properties" : { "Status" : { "select" : { "name" : "Done" }}}} });
curl -X PATCH "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.notion.com%2Fv1%2Fpages%2F%7Bpage_id%7D" \ -H "Authorization: Bearer $LAVA_SECRET_KEY " \ -H "Content-Type: application/json" \ -d '{"properties":{"Status":{"select":{"name":"Done"}}}}'
Delete a block DELETE https://api.notion.com/v1/blocks/{block_id} — Freeconst data = await lava . gateway ( 'https://api.notion.com/v1/blocks/{block_id}' , { method: 'DELETE' });
curl -X DELETE "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.notion.com%2Fv1%2Fblocks%2F%7Bblock_id%7D" \ -H "Authorization: Bearer $LAVA_SECRET_KEY " \ -H "Content-Type: application/json"
Next Steps
All Providers Browse all supported AI providers
Forward Proxy Learn how to construct proxy URLs and authenticate requests
