Authentication: OAuth or integration token. See Magic Link for the runtime auth flow, or Application credentials to bring your own OAuth app.
Engineering Wiki for pages last edited over 60 days ago and tagged runbook for archive review.Decisions Log database with today’s architecture decision.Product / Specs blocked on review and DM the reviewer.Append child blocks to a parent block. CRITICAL: children parameter must be native JSON array of block objects, NOT strings. Use [{“object”: “block”, “type”: “paragraph”, …}] format.
Retrieve a block by ID
Retrieve children of a block with pagination
Update a block’s content or properties. CRITICAL: All block properties must be native JSON objects, NOT strings. Use proper block type structure.
Delete a block
Create a comment on a page or block
List comments for a block or get ALL comments from an entire page
Create a new database in Notion with specified schema, properties, and parent page. Requires properly structured parent object with type field and valid page_id.
Query a database with filtering, sorting, and pagination.
Retrieve a database by ID
Update database properties, title, description, icon, cover, and schema
Create a new page in Notion under an existing page or database.
Retrieve a page by ID
Retrieve a specific page property
Update page properties, icon, cover, or archive status
Archive a page (move to trash)
Search for pages and databases by title
List all users in the workspace
Retrieve a user by ID
Retrieve the current integration’s bot user
Validate Notion credentials by fetching the bot user. Returns {success, message}.