Notion Agent APIs in public beta
By Steven Van ·
The Notion Agent APIs are now in public beta.
Notion's Agent APIs are now in public beta. Sessions let a developer start a chat with a Custom Agent, stream its reply, submit an action, and page through a session's event history, so a Custom Agent can be wired into a Slack bot, an internal tool, or a mobile client. A quickstart walks through a first request end to end with a personal access token.
The beta also covers managing Custom Agents programmatically:
- Find the agents a token can reach with Query agents
- Read per-agent usage with Retrieve agent insights
- Set credit limits, and enable, disable, or delete agents, individually or in an asynchronous batch
Anyone who built against the private alpha routes for agents, threads, messages, or chat needs to move to the new ones: they take JSON request bodies instead of query parameters, and return sessions and events instead of threads and messages. The alpha routes must be migrated off by September 30, 2026.
