{"id":"org_cOwRRJFh-eHQ4Amk7Vm1j","slug":"notion","name":"Notion","domain":"notion.com","description":null,"category":null,"tags":[],"sourceCount":3,"releaseCount":221,"releasesLast30Days":27,"avgReleasesPerWeek":4.1,"lastFetchedAt":"2026-04-19T04:00:36.334Z","trackingSince":"2020-01-09T00:00:00.000Z","aliases":["notion.so"],"accounts":[{"platform":"github","handle":"makenotion"}],"products":[],"sources":[{"id":"src_iHfpL4HZf3Y-Gf5bEuvM_","slug":"notion-mcp-server","name":"MCP Server","type":"github","url":"https://github.com/makenotion/notion-mcp-server","isPrimary":false,"isHidden":false,"fetchPriority":"normal","releaseCount":1,"latestVersion":"v2.1.0","latestDate":"2026-01-31T18:27:31.000Z","latestAddedAt":"2026-04-03T15:01:11.499Z","productSlug":null,"productName":null},{"id":"src_nhFxCqqLmc54Ye7LxCGUw","slug":"notion-releases","name":"Notion Releases","type":"scrape","url":"https://www.notion.com/releases","isPrimary":false,"isHidden":false,"fetchPriority":"normal","releaseCount":140,"latestVersion":"2.7","latestDate":"2026-04-17T00:00:00.000Z","latestAddedAt":"2026-04-18T15:00:57.443Z","productSlug":null,"productName":null},{"id":"src_6kc5TQLb45yVLMzCGnMbg","slug":"notion-sdk-js","name":"SDK (JS)","type":"github","url":"https://github.com/makenotion/notion-sdk-js","isPrimary":false,"isHidden":false,"fetchPriority":"normal","releaseCount":79,"latestVersion":"v5.19.0","latestDate":"2026-04-17T18:51:55.000Z","latestAddedAt":"2026-04-17T20:02:36.008Z","productSlug":null,"productName":null}],"overview":{"scope":"org","content":"The JS SDK is tracking fast-moving API surface changes alongside product features shipped to the main platform. Recent work emphasizes AI capabilities, block types, and granular API control.\n\n**Comments now accept markdown formatting** in v5.17.0, matching broader richtext support across the platform.\n\n**Views API landed in v5.14.0**, enabling programmatic access to database views including the newly shipped dashboard view type. The SDK also synced support for H4 blocks, status properties, and \"me\" person filters in the same window. This reflects Notion's push toward richer database visualization—dashboards and tabs are primary UI features in the March releases, now exposed to developers.\n\n**Markdown endpoints for pages** shipped in v5.11.0 with `pages.retrieveMarkdown()` and `pages.updateMarkdown()`, giving developers a content-first API alternative to block-level manipulation. v5.13.0 extended this with `update_content` and `replace_content` operations, enabling partial markdown edits.\n\n**Tab block support** rolled through the SDK in v5.15.0 as the product shipped tabs for organizing page sections. The same release modularized `api-endpoints.ts` into separate files and added `custom_emojis.list()`.\n\n**Icon support for paragraph blocks** and new `APIErrorCode.gateway_timeout` landed in v5.16.0, tracking platform stabilization.\n\n**Security fix in v5.9.0** blocked path traversal via `../` sequences in `Client.request()` calls. Callers must now use properly formatted absolute API paths instead.\n\n**Retry logic with exponential backoff** shipped in v5.10.0, improving resilience for transient failures.\n\n**MCP Server v2.1.0** added tool annotations for better LLM understanding, fixed JSON double-serialization bugs from MCP clients, and exposed the retrieve database endpoint in its OpenAPI spec.","releaseCount":32,"lastContributingReleaseAt":"2026-04-07T17:14:42.000Z","generatedAt":"2026-04-08T12:59:39.318Z","updatedAt":"2026-04-08T13:05:23.581Z"},"knowledgePage":{"scope":"org","content":"The JS SDK is tracking fast-moving API surface changes alongside product features shipped to the main platform. Recent work emphasizes AI capabilities, block types, and granular API control.\n\n**Comments now accept markdown formatting** in v5.17.0, matching broader richtext support across the platform.\n\n**Views API landed in v5.14.0**, enabling programmatic access to database views including the newly shipped dashboard view type. The SDK also synced support for H4 blocks, status properties, and \"me\" person filters in the same window. This reflects Notion's push toward richer database visualization—dashboards and tabs are primary UI features in the March releases, now exposed to developers.\n\n**Markdown endpoints for pages** shipped in v5.11.0 with `pages.retrieveMarkdown()` and `pages.updateMarkdown()`, giving developers a content-first API alternative to block-level manipulation. v5.13.0 extended this with `update_content` and `replace_content` operations, enabling partial markdown edits.\n\n**Tab block support** rolled through the SDK in v5.15.0 as the product shipped tabs for organizing page sections. The same release modularized `api-endpoints.ts` into separate files and added `custom_emojis.list()`.\n\n**Icon support for paragraph blocks** and new `APIErrorCode.gateway_timeout` landed in v5.16.0, tracking platform stabilization.\n\n**Security fix in v5.9.0** blocked path traversal via `../` sequences in `Client.request()` calls. Callers must now use properly formatted absolute API paths instead.\n\n**Retry logic with exponential backoff** shipped in v5.10.0, improving resilience for transient failures.\n\n**MCP Server v2.1.0** added tool annotations for better LLM understanding, fixed JSON double-serialization bugs from MCP clients, and exposed the retrieve database endpoint in its OpenAPI spec.","releaseCount":32,"lastContributingReleaseAt":"2026-04-07T17:14:42.000Z","generatedAt":"2026-04-08T12:59:39.318Z","updatedAt":"2026-04-08T13:05:23.581Z"},"playbook":{"scope":"playbook","content":"# Notion — Playbook\n\n> Agent reference for fetching and maintaining **Notion** (`notion`) changelog sources.\n\n**3** active sources · domain: notion.com\n\n## Sources\n\n| Name | ID | Type | URL | Last Fetched |\n|------|-----|------|-----|--------------|\n| Notion Releases | `src_nhFxCqqLmc54Ye7LxCGUw` | scrape | https://www.notion.com/releases | Apr 18 |\n| MCP Server | `src_iHfpL4HZf3Y-Gf5bEuvM_` | github | https://github.com/makenotion/notion-mcp-server | Apr 18 |\n| SDK (JS) | `src_6kc5TQLb45yVLMzCGnMbg` | github | https://github.com/makenotion/notion-sdk-js | Apr 18 |\n\n## Agent Notes\n\n### Fetch instructions\n\n**notion-releases (scrape)**\nSource URL: https://www.notion.com/releases (Next.js SSR, no JS rendering needed).\nCrawl mode enabled with pattern https://www.notion.com/releases/** and crawlRender=false.\nCrawl discovers ~23 individual release pages and parses them via AI, yielding 10+ releases per fetch with full content, media, and YouTube embeds.\n\nThe RSS feed at /releases/rss.xml has 119 items but is TITLE-ONLY (no content/description). Feed metadata is cleared (noFeedFound=true) to skip it.\nIndividual release pages follow pattern /releases/YYYY-MM-DD and are server-rendered with full content.\nIndex page paginates at /releases/page/N (10 items per page, ~13 pages).\nLinks in RSS use notion.so domain which 301-redirects to notion.com — crawl patterns must use notion.com.\n\n**notion-mcp-server, notion-sdk-js (github)**\nStandard GitHub releases. No special handling needed.\n\n### Traps\n- **Domain mismatch**: notion.so redirects to notion.com. All crawl patterns and URL references must use notion.com.\n- **Title-only RSS**: The RSS feed exists but carries zero content. Do not re-enable feed mode — it was producing empty releases.\n- **Pagination URLs**: Crawl may pick up /releases/page/N pagination pages alongside date-based pages. Suppress any releases with pagination URLs.\n- **Feature name reuse**: Notion iterates on the same feature across multiple date pages (e.g., \"Customize your tabs\" appears on 3 different dates). These are distinct releases with unique URLs, not duplicates.\n\n### Coverage\nPlatform releases covered via scrape/crawl of notion.com/releases. MCP server and JS SDK covered via GitHub. Notion does not publish a traditional changelog with version numbers — releases are date-based (YYYY-MM-DD).\n","updatedAt":"2026-04-18T20:42:34.701Z"}}