npx @buildinternet/releases get notionRecently shipped SDK v5.27.0 with a browser token guard, the Agent Skills API, and typed databases.
Browser clients refuse tokens by default. Constructing a client with auth in a browser page, web worker, or service worker now throws BrowserTokenNotAllowedError; per-request auth and OAuth client credentials reject the same way before anything is sent. Pass dangerouslyAllowBrowser: true to opt out — jsdom tests, for example. A client without a token still works in a browser, such as one pointed at your own server via baseUrl.
Agent Skills reached the SDK, alongside typed databases. client.plugins.list() and client.plugins.retrieve() browse plugins, and client.skills.retrieve() returns a signed archive URL; the SDK doesn't download or extract the files.
The iOS app stayed on bug fixes. Releases 1.7.334 through 1.7.346 all shipped bug fixes and performance improvements, with no new capabilities.
Agent and session APIs from v5.26.0 still stand. client.agents and client.sessions cover retrieval, queries, status and credit-limit updates, cancellation, and SSE streaming with retry before the stream opens. Write responses still honor filter_properties, and verification filters still accept does_not_equal. Meeting-notes block creation and the External Agents API GA remain available.
Cloudflare Workers and Deno worker threads are no longer detected as browsers, restoring client creation with auth and the user-agent header after v5.27.0 threw BrowserTokenNotAllowedError. The dangerouslyAllowBrowser workaround can now be removed on server runtimes.
Notion 3.8 adds MCP connections so agents can read workspace context and act across 150+ external tools, a Skills API for syncing agent skills across ChatGPT and Claude, and column permissions that control which database properties each person or agent can view or edit. Also rebuilt synced databases for GitHub, Jira, and Salesforce, upgraded version history across pages and databases, and added support for using a ChatGPT Plus or Pro plan for AI usage in Notion.
Constructing a client with auth in a browser, web worker, or service worker now throws BrowserTokenNotAllowedError unless dangerouslyAllowBrowser: true is passed. Adds client.plugins and client.skills methods returning signed archive URLs, typed databases with a database_type field, and updates agent response types including the notion_ai personal agent ID.
Skills are reusable instructions teams can store in a shared skills library and run from Notion Agent, with SKILL.md files downloadable to Claude Code, Codex, Cursor, Gemini, and Grok. Also new: Custom Agents can call other Custom Agents as sub-agents, connect GitHub and Amplitude via Custom MCP in beta, and run post-meeting work automatically on Business and Enterprise plans.
Workspace owners can choose which AI models are available in Notion Agent and Custom Agents separately, and set a default model for Custom Agents. Available on Business and Enterprise plans, configured under Settings, Notion AI, General, Model controls.
Adds client.agents methods for retrieving, querying, deleting, and batching agents, plus client.sessions methods for retrieving, updating, canceling, and querying sessions, session events, and streamed responses. Session streaming returns an async iterable that retries eligible HTTP failures before opening, without replaying events after streaming begins, and introduces typed session events and metadata.