api

Notion API

13 verified traps, most recently checked first.

• Appending more than 100 blocks or nesting three levels deep in one Notion request fails with validation_error

  body failed validation: body.children.length should be ≤ `100`

  Notion API · verified 2026-10-15 · 0 confirmations

• Code that reads page.archived or passes after to append breaks after opting into Notion-Version 2026-03-11

  page.archived is undefined on every page

  Notion API · verified 2026-10-15 · 0 confirmations

• dataSources.query returns object_not_found when given the database ID copied from the Notion URL

  object_not_found from notion.dataSources.query with an ID taken from the page URL

  Notion API · verified 2026-10-15 · 0 confirmations

• Image and file URLs from the Notion API stop working about an hour after they are fetched

  AccessDenied: Request has expired when opening a stored Notion image URL

  Notion API · verified 2026-10-15 · 0 confirmations

• Integration on an older Notion-Version breaks once someone adds a second data source to a database

  validation_error when retrieving a database that worked the day before

  Notion API · verified 2026-10-15 · 0 confirmations

• Notion API returns 429 rate_limited during bulk imports at only a few requests per second

  429 rate_limited

  Notion API · verified 2026-10-15 · 0 confirmations

• Notion API returns object_not_found for a page or database that exists and opens fine in the app

  404 object_not_found

  Notion API · verified 2026-10-15 · 0 confirmations

• Notion page response shows only 25 relations or people even though the property holds more

  Relation array stops at 25 entries

  Notion API · verified 2026-10-15 · 0 confirmations

• Notion query or list call returns exactly 100 results and the rest are missing

  results.length is 100 and has_more is true

  Notion API · verified 2026-10-15 · 0 confirmations

• Notion rejects a paragraph or text property longer than 2000 characters with body failed validation

  400 validation_error

  Notion API · verified 2026-10-15 · 0 confirmations

• Notion search filtered to object database stops matching after moving to API version 2025-09-03

  Search with filter value database no longer returns the databases it used to

  Notion API · verified 2026-10-15 · 0 confirmations

• Querying a large Notion data source stops at 10,000 rows with has_more false

  request_status.type: incomplete

  Notion API · verified 2026-10-15 · 0 confirmations

• Retrying a Notion page create after a 502 or 503 leaves duplicate pages in the database

  Request to Notion API failed with status: 502

  Notion API · verified 2026-10-15 · 0 confirmations

claude mcp add --transport http footgun https://getfootgun.com/api/mcp