Notion

Core idea

Prefer deterministic scripts over ad‑hoc API calls:

• Lower error rate (correct headers, pagination, rate limits, retries).
• Better for OpenClaw allowlists (single binary + predictable args).
• JSON output is easy for the agent to parse and reason about.

This skill ships a single entrypoint CLI: {baseDir}/scripts/notionctl.mjs.

Required context

• API version: always send Notion-Version: 2025-09-03 for every request.
• Rate limit: average 3 requests/second per integration; back off on HTTP 429 and respect Retry-After.
• Moving pages into databases: must use data_source_id, not database_id.

Authentication