[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-openclaw-openclaw-skills-notion":3},{"error":4,"detail":5,"metadata":23,"markdownContent":25,"rawMarkdown":20},false,{"repo_full_name":6,"owner":7,"repo_name":7,"repo_forks":8,"skill_path":9,"repo_stars":10,"name":11,"category_id":12,"description":13,"file_tree":14,"skill_md_content":20,"skill_id":21,"skill_key":22},"openclaw/openclaw","openclaw",62348,"skills/notion",323515,"notion",1,"Notion API for creating and managing pages, databases, and blocks.",[15],{"name":16,"path":17,"size":18,"type":19},"SKILL.md","skills/notion/SKILL.md",5381,"file","---\nname: notion\ndescription: Notion API for creating and managing pages, databases, and blocks.\nhomepage: https://developers.notion.com\nmetadata:\n  {\n    \"openclaw\":\n      { \"emoji\": \"📝\", \"requires\": { \"env\": [\"NOTION_API_KEY\"] }, \"primaryEnv\": \"NOTION_API_KEY\" },\n  }\n---\n\n# notion\n\nUse the Notion API to create/read/update pages, data sources (databases), and blocks.\n\n## Setup\n\n1. Create an integration at https://notion.so/my-integrations\n2. Copy the API key (starts with `ntn_` or `secret_`)\n3. Store it:\n\n```bash\nmkdir -p ~/.config/notion\necho \"ntn_your_key_here\" > ~/.config/notion/api_key\n```\n\n4. Share target pages/databases with your integration (click \"...\" → \"Connect to\" → your integration name)\n\n## API Basics\n\nAll requests need:\n\n```bash\nNOTION_KEY=$(cat ~/.config/notion/api_key)\ncurl -X GET \"https://api.notion.com/v1/...\" \\\n  -H \"Authorization: Bearer $NOTION_KEY\" \\\n  -H \"Notion-Version: 2025-09-03\" \\\n  -H \"Content-Type: application/json\"\n```\n\n> **Note:** The `Notion-Version` header is required. This skill uses `2025-09-03` (latest). In this version, databases are called \"data sources\" in the API.\n\n## Common Operations\n\n**Search for pages and data sources:**\n\n```bash\ncurl -X POST \"https://api.notion.com/v1/search\" \\\n  -H \"Authorization: Bearer $NOTION_KEY\" \\\n  -H \"Notion-Version: 2025-09-03\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"query\": \"page title\"}'\n```\n\n**Get page:**\n\n```bash\ncurl \"https://api.notion.com/v1/pages/{page_id}\" \\\n  -H \"Authorization: Bearer $NOTION_KEY\" \\\n  -H \"Notion-Version: 2025-09-03\"\n```\n\n**Get page content (blocks):**\n\n```bash\ncurl \"https://api.notion.com/v1/blocks/{page_id}/children\" \\\n  -H \"Authorization: Bearer $NOTION_KEY\" \\\n  -H \"Notion-Version: 2025-09-03\"\n```\n\n**Create page in a data source:**\n\n```bash\ncurl -X POST \"https://api.notion.com/v1/pages\" \\\n  -H \"Authorization: Bearer $NOTION_KEY\" \\\n  -H \"Notion-Version: 2025-09-03\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"parent\": {\"database_id\": \"xxx\"},\n    \"properties\": {\n      \"Name\": {\"title\": [{\"text\": {\"content\": \"New Item\"}}]},\n      \"Status\": {\"select\": {\"name\": \"Todo\"}}\n    }\n  }'\n```\n\n**Query a data source (database):**\n\n```bash\ncurl -X POST \"https://api.notion.com/v1/data_sources/{data_source_id}/query\" \\\n  -H \"Authorization: Bearer $NOTION_KEY\" \\\n  -H \"Notion-Version: 2025-09-03\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"filter\": {\"property\": \"Status\", \"select\": {\"equals\": \"Active\"}},\n    \"sorts\": [{\"property\": \"Date\", \"direction\": \"descending\"}]\n  }'\n```\n\n**Create a data source (database):**\n\n```bash\ncurl -X POST \"https://api.notion.com/v1/data_sources\" \\\n  -H \"Authorization: Bearer $NOTION_KEY\" \\\n  -H \"Notion-Version: 2025-09-03\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"parent\": {\"page_id\": \"xxx\"},\n    \"title\": [{\"text\": {\"content\": \"My Database\"}}],\n    \"properties\": {\n      \"Name\": {\"title\": {}},\n      \"Status\": {\"select\": {\"options\": [{\"name\": \"Todo\"}, {\"name\": \"Done\"}]}},\n      \"Date\": {\"date\": {}}\n    }\n  }'\n```\n\n**Update page properties:**\n\n```bash\ncurl -X PATCH \"https://api.notion.com/v1/pages/{page_id}\" \\\n  -H \"Authorization: Bearer $NOTION_KEY\" \\\n  -H \"Notion-Version: 2025-09-03\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"properties\": {\"Status\": {\"select\": {\"name\": \"Done\"}}}}'\n```\n\n**Add blocks to page:**\n\n```bash\ncurl -X PATCH \"https://api.notion.com/v1/blocks/{page_id}/children\" \\\n  -H \"Authorization: Bearer $NOTION_KEY\" \\\n  -H \"Notion-Version: 2025-09-03\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"children\": [\n      {\"object\": \"block\", \"type\": \"paragraph\", \"paragraph\": {\"rich_text\": [{\"text\": {\"content\": \"Hello\"}}]}}\n    ]\n  }'\n```\n\n## Property Types\n\nCommon property formats for database items:\n\n- **Title:** `{\"title\": [{\"text\": {\"content\": \"...\"}}]}`\n- **Rich text:** `{\"rich_text\": [{\"text\": {\"content\": \"...\"}}]}`\n- **Select:** `{\"select\": {\"name\": \"Option\"}}`\n- **Multi-select:** `{\"multi_select\": [{\"name\": \"A\"}, {\"name\": \"B\"}]}`\n- **Date:** `{\"date\": {\"start\": \"2024-01-15\", \"end\": \"2024-01-16\"}}`\n- **Checkbox:** `{\"checkbox\": true}`\n- **Number:** `{\"number\": 42}`\n- **URL:** `{\"url\": \"https://...\"}`\n- **Email:** `{\"email\": \"a@b.com\"}`\n- **Relation:** `{\"relation\": [{\"id\": \"page_id\"}]}`\n\n## Key Differences in 2025-09-03\n\n- **Databases → Data Sources:** Use `/data_sources/` endpoints for queries and retrieval\n- **Two IDs:** Each database now has both a `database_id` and a `data_source_id`\n  - Use `database_id` when creating pages (`parent: {\"database_id\": \"...\"}`)\n  - Use `data_source_id` when querying (`POST /v1/data_sources/{id}/query`)\n- **Search results:** Databases return as `\"object\": \"data_source\"` with their `data_source_id`\n- **Parent in responses:** Pages show `parent.data_source_id` alongside `parent.database_id`\n- **Finding the data_source_id:** Search for the database, or call `GET /v1/data_sources/{data_source_id}`\n\n## Notes\n\n- Page/database IDs are UUIDs (with or without dashes)\n- The API cannot set database view filters — that's UI-only\n- Rate limit: ~3 requests/second average, with `429 rate_limited` responses using `Retry-After`\n- Append block children: up to 100 children per request, up to two levels of nesting in a single append request\n- Payload size limits: up to 1000 block elements and 500KB overall\n- Use `is_inline: true` when creating data sources to embed them in pages\n","81eb5113-cf24-5440-9bd9-1f6aaf5d24c6","openclaw-openclaw-skills-notion",{"name":11,"description":13,"homepage":24},"https://developers.notion.com","\u003Ch1>notion\u003C/h1>\n\u003Cp>Use the Notion API to create/read/update pages, data sources (databases), and blocks.\u003C/p>\n\u003Ch2>Setup\u003C/h2>\n\u003Col>\n\u003Cli>Create an integration at \u003Ca href=\"https://notion.so/my-integrations\">https://notion.so/my-integrations\u003C/a>\u003C/li>\n\u003Cli>Copy the API key (starts with \u003Ccode>ntn_\u003C/code> or \u003Ccode>secret_\u003C/code>)\u003C/li>\n\u003Cli>Store it:\u003C/li>\n\u003C/ol>\n\u003Cdiv class=\"md-code-block\">\u003Cdiv class=\"md-code-lang\">bash\u003C/div>\u003Cpre>\u003Ccode class=\"hljs language-bash\">\u003Cspan class=\"hljs-built_in\">mkdir\u003C/span> -p ~/.config/notion\n\u003Cspan class=\"hljs-built_in\">echo\u003C/span> \u003Cspan class=\"hljs-string\">"ntn_your_key_here"\u003C/span> > ~/.config/notion/api_key\u003C/code>\u003C/pre>\u003C/div>\u003Col start=\"4\">\n\u003Cli>Share target pages/databases with your integration (click "..." → "Connect to" → your integration name)\u003C/li>\n\u003C/ol>\n\u003Ch2>API Basics\u003C/h2>\n\u003Cp>All requests need:\u003C/p>\n\u003Cdiv class=\"md-code-block\">\u003Cdiv class=\"md-code-lang\">bash\u003C/div>\u003Cpre>\u003Ccode class=\"hljs language-bash\">NOTION_KEY=$(\u003Cspan class=\"hljs-built_in\">cat\u003C/span> ~/.config/notion/api_key)\ncurl -X GET \u003Cspan class=\"hljs-string\">"https://api.notion.com/v1/..."\u003C/span> \\\n  -H \u003Cspan class=\"hljs-string\">"Authorization: Bearer \u003Cspan class=\"hljs-variable\">$NOTION_KEY\u003C/span>"\u003C/span> \\\n  -H \u003Cspan class=\"hljs-string\">"Notion-Version: 2025-09-03"\u003C/span> \\\n  -H \u003Cspan class=\"hljs-string\">"Content-Type: application/json"\u003C/span>\u003C/code>\u003C/pre>\u003C/div>\u003Cblockquote>\n\u003Cp>\u003Cstrong>Note:\u003C/strong> The \u003Ccode>Notion-Version\u003C/code> header is required. This skill uses \u003Ccode>2025-09-03\u003C/code> (latest). In this version, databases are called "data sources" in the API.\u003C/p>\n\u003C/blockquote>\n\u003Ch2>Common Operations\u003C/h2>\n\u003Cp>\u003Cstrong>Search for pages and data sources:\u003C/strong>\u003C/p>\n\u003Cdiv class=\"md-code-block\">\u003Cdiv class=\"md-code-lang\">bash\u003C/div>\u003Cpre>\u003Ccode class=\"hljs language-bash\">curl -X POST \u003Cspan class=\"hljs-string\">"https://api.notion.com/v1/search"\u003C/span> \\\n  -H \u003Cspan class=\"hljs-string\">"Authorization: Bearer \u003Cspan class=\"hljs-variable\">$NOTION_KEY\u003C/span>"\u003C/span> \\\n  -H \u003Cspan class=\"hljs-string\">"Notion-Version: 2025-09-03"\u003C/span> \\\n  -H \u003Cspan class=\"hljs-string\">"Content-Type: application/json"\u003C/span> \\\n  -d \u003Cspan class=\"hljs-string\">'{"query": "page title"}'\u003C/span>\u003C/code>\u003C/pre>\u003C/div>\u003Cp>\u003Cstrong>Get page:\u003C/strong>\u003C/p>\n\u003Cdiv class=\"md-code-block\">\u003Cdiv class=\"md-code-lang\">bash\u003C/div>\u003Cpre>\u003Ccode class=\"hljs language-bash\">curl \u003Cspan class=\"hljs-string\">"https://api.notion.com/v1/pages/{page_id}"\u003C/span> \\\n  -H \u003Cspan class=\"hljs-string\">"Authorization: Bearer \u003Cspan class=\"hljs-variable\">$NOTION_KEY\u003C/span>"\u003C/span> \\\n  -H \u003Cspan class=\"hljs-string\">"Notion-Version: 2025-09-03"\u003C/span>\u003C/code>\u003C/pre>\u003C/div>\u003Cp>\u003Cstrong>Get page content (blocks):\u003C/strong>\u003C/p>\n\u003Cdiv class=\"md-code-block\">\u003Cdiv class=\"md-code-lang\">bash\u003C/div>\u003Cpre>\u003Ccode class=\"hljs language-bash\">curl \u003Cspan class=\"hljs-string\">"https://api.notion.com/v1/blocks/{page_id}/children"\u003C/span> \\\n  -H \u003Cspan class=\"hljs-string\">"Authorization: Bearer \u003Cspan class=\"hljs-variable\">$NOTION_KEY\u003C/span>"\u003C/span> \\\n  -H \u003Cspan class=\"hljs-string\">"Notion-Version: 2025-09-03"\u003C/span>\u003C/code>\u003C/pre>\u003C/div>\u003Cp>\u003Cstrong>Create page in a data source:\u003C/strong>\u003C/p>\n\u003Cdiv class=\"md-code-block\">\u003Cdiv class=\"md-code-lang\">bash\u003C/div>\u003Cpre>\u003Ccode class=\"hljs language-bash\">curl -X POST \u003Cspan class=\"hljs-string\">"https://api.notion.com/v1/pages"\u003C/span> \\\n  -H \u003Cspan class=\"hljs-string\">"Authorization: Bearer \u003Cspan class=\"hljs-variable\">$NOTION_KEY\u003C/span>"\u003C/span> \\\n  -H \u003Cspan class=\"hljs-string\">"Notion-Version: 2025-09-03"\u003C/span> \\\n  -H \u003Cspan class=\"hljs-string\">"Content-Type: application/json"\u003C/span> \\\n  -d \u003Cspan class=\"hljs-string\">'{\n    "parent": {"database_id": "xxx"},\n    "properties": {\n      "Name": {"title": [{"text": {"content": "New Item"}}]},\n      "Status": {"select": {"name": "Todo"}}\n    }\n  }'\u003C/span>\u003C/code>\u003C/pre>\u003C/div>\u003Cp>\u003Cstrong>Query a data source (database):\u003C/strong>\u003C/p>\n\u003Cdiv class=\"md-code-block\">\u003Cdiv class=\"md-code-lang\">bash\u003C/div>\u003Cpre>\u003Ccode class=\"hljs language-bash\">curl -X POST \u003Cspan class=\"hljs-string\">"https://api.notion.com/v1/data_sources/{data_source_id}/query"\u003C/span> \\\n  -H \u003Cspan class=\"hljs-string\">"Authorization: Bearer \u003Cspan class=\"hljs-variable\">$NOTION_KEY\u003C/span>"\u003C/span> \\\n  -H \u003Cspan class=\"hljs-string\">"Notion-Version: 2025-09-03"\u003C/span> \\\n  -H \u003Cspan class=\"hljs-string\">"Content-Type: application/json"\u003C/span> \\\n  -d \u003Cspan class=\"hljs-string\">'{\n    "filter": {"property": "Status", "select": {"equals": "Active"}},\n    "sorts": [{"property": "Date", "direction": "descending"}]\n  }'\u003C/span>\u003C/code>\u003C/pre>\u003C/div>\u003Cp>\u003Cstrong>Create a data source (database):\u003C/strong>\u003C/p>\n\u003Cdiv class=\"md-code-block\">\u003Cdiv class=\"md-code-lang\">bash\u003C/div>\u003Cpre>\u003Ccode class=\"hljs language-bash\">curl -X POST \u003Cspan class=\"hljs-string\">"https://api.notion.com/v1/data_sources"\u003C/span> \\\n  -H \u003Cspan class=\"hljs-string\">"Authorization: Bearer \u003Cspan class=\"hljs-variable\">$NOTION_KEY\u003C/span>"\u003C/span> \\\n  -H \u003Cspan class=\"hljs-string\">"Notion-Version: 2025-09-03"\u003C/span> \\\n  -H \u003Cspan class=\"hljs-string\">"Content-Type: application/json"\u003C/span> \\\n  -d \u003Cspan class=\"hljs-string\">'{\n    "parent": {"page_id": "xxx"},\n    "title": [{"text": {"content": "My Database"}}],\n    "properties": {\n      "Name": {"title": {}},\n      "Status": {"select": {"options": [{"name": "Todo"}, {"name": "Done"}]}},\n      "Date": {"date": {}}\n    }\n  }'\u003C/span>\u003C/code>\u003C/pre>\u003C/div>\u003Cp>\u003Cstrong>Update page properties:\u003C/strong>\u003C/p>\n\u003Cdiv class=\"md-code-block\">\u003Cdiv class=\"md-code-lang\">bash\u003C/div>\u003Cpre>\u003Ccode class=\"hljs language-bash\">curl -X PATCH \u003Cspan class=\"hljs-string\">"https://api.notion.com/v1/pages/{page_id}"\u003C/span> \\\n  -H \u003Cspan class=\"hljs-string\">"Authorization: Bearer \u003Cspan class=\"hljs-variable\">$NOTION_KEY\u003C/span>"\u003C/span> \\\n  -H \u003Cspan class=\"hljs-string\">"Notion-Version: 2025-09-03"\u003C/span> \\\n  -H \u003Cspan class=\"hljs-string\">"Content-Type: application/json"\u003C/span> \\\n  -d \u003Cspan class=\"hljs-string\">'{"properties": {"Status": {"select": {"name": "Done"}}}}'\u003C/span>\u003C/code>\u003C/pre>\u003C/div>\u003Cp>\u003Cstrong>Add blocks to page:\u003C/strong>\u003C/p>\n\u003Cdiv class=\"md-code-block\">\u003Cdiv class=\"md-code-lang\">bash\u003C/div>\u003Cpre>\u003Ccode class=\"hljs language-bash\">curl -X PATCH \u003Cspan class=\"hljs-string\">"https://api.notion.com/v1/blocks/{page_id}/children"\u003C/span> \\\n  -H \u003Cspan class=\"hljs-string\">"Authorization: Bearer \u003Cspan class=\"hljs-variable\">$NOTION_KEY\u003C/span>"\u003C/span> \\\n  -H \u003Cspan class=\"hljs-string\">"Notion-Version: 2025-09-03"\u003C/span> \\\n  -H \u003Cspan class=\"hljs-string\">"Content-Type: application/json"\u003C/span> \\\n  -d \u003Cspan class=\"hljs-string\">'{\n    "children": [\n      {"object": "block", "type": "paragraph", "paragraph": {"rich_text": [{"text": {"content": "Hello"}}]}}\n    ]\n  }'\u003C/span>\u003C/code>\u003C/pre>\u003C/div>\u003Ch2>Property Types\u003C/h2>\n\u003Cp>Common property formats for database items:\u003C/p>\n\u003Cul>\n\u003Cli>\u003Cstrong>Title:\u003C/strong> \u003Ccode>{"title": [{"text": {"content": "..."}}]}\u003C/code>\u003C/li>\n\u003Cli>\u003Cstrong>Rich text:\u003C/strong> \u003Ccode>{"rich_text": [{"text": {"content": "..."}}]}\u003C/code>\u003C/li>\n\u003Cli>\u003Cstrong>Select:\u003C/strong> \u003Ccode>{"select": {"name": "Option"}}\u003C/code>\u003C/li>\n\u003Cli>\u003Cstrong>Multi-select:\u003C/strong> \u003Ccode>{"multi_select": [{"name": "A"}, {"name": "B"}]}\u003C/code>\u003C/li>\n\u003Cli>\u003Cstrong>Date:\u003C/strong> \u003Ccode>{"date": {"start": "2024-01-15", "end": "2024-01-16"}}\u003C/code>\u003C/li>\n\u003Cli>\u003Cstrong>Checkbox:\u003C/strong> \u003Ccode>{"checkbox": true}\u003C/code>\u003C/li>\n\u003Cli>\u003Cstrong>Number:\u003C/strong> \u003Ccode>{"number": 42}\u003C/code>\u003C/li>\n\u003Cli>\u003Cstrong>URL:\u003C/strong> \u003Ccode>{"url": "https://..."}\u003C/code>\u003C/li>\n\u003Cli>\u003Cstrong>Email:\u003C/strong> \u003Ccode>{"email": "a@b.com"}\u003C/code>\u003C/li>\n\u003Cli>\u003Cstrong>Relation:\u003C/strong> \u003Ccode>{"relation": [{"id": "page_id"}]}\u003C/code>\u003C/li>\n\u003C/ul>\n\u003Ch2>Key Differences in 2025-09-03\u003C/h2>\n\u003Cul>\n\u003Cli>\u003Cstrong>Databases → Data Sources:\u003C/strong> Use \u003Ccode>/data_sources/\u003C/code> endpoints for queries and retrieval\u003C/li>\n\u003Cli>\u003Cstrong>Two IDs:\u003C/strong> Each database now has both a \u003Ccode>database_id\u003C/code> and a \u003Ccode>data_source_id\u003C/code>\u003Cul>\n\u003Cli>Use \u003Ccode>database_id\u003C/code> when creating pages (\u003Ccode>parent: {"database_id": "..."}\u003C/code>)\u003C/li>\n\u003Cli>Use \u003Ccode>data_source_id\u003C/code> when querying (\u003Ccode>POST /v1/data_sources/{id}/query\u003C/code>)\u003C/li>\n\u003C/ul>\n\u003C/li>\n\u003Cli>\u003Cstrong>Search results:\u003C/strong> Databases return as \u003Ccode>"object": "data_source"\u003C/code> with their \u003Ccode>data_source_id\u003C/code>\u003C/li>\n\u003Cli>\u003Cstrong>Parent in responses:\u003C/strong> Pages show \u003Ccode>parent.data_source_id\u003C/code> alongside \u003Ccode>parent.database_id\u003C/code>\u003C/li>\n\u003Cli>\u003Cstrong>Finding the data_source_id:\u003C/strong> Search for the database, or call \u003Ccode>GET /v1/data_sources/{data_source_id}\u003C/code>\u003C/li>\n\u003C/ul>\n\u003Ch2>Notes\u003C/h2>\n\u003Cul>\n\u003Cli>Page/database IDs are UUIDs (with or without dashes)\u003C/li>\n\u003Cli>The API cannot set database view filters — that's UI-only\u003C/li>\n\u003Cli>Rate limit: ~3 requests/second average, with \u003Ccode>429 rate_limited\u003C/code> responses using \u003Ccode>Retry-After\u003C/code>\u003C/li>\n\u003Cli>Append block children: up to 100 children per request, up to two levels of nesting in a single append request\u003C/li>\n\u003Cli>Payload size limits: up to 1000 block elements and 500KB overall\u003C/li>\n\u003Cli>Use \u003Ccode>is_inline: true\u003C/code> when creating data sources to embed them in pages\u003C/li>\n\u003C/ul>\n"]