Notion changed its API changelog
API changeloghttps://developers.notion.com/page/changelog
ChangeAPI changelog
Notion Agent APIs moved to public beta with September 30, 2026 migration deadline for private alpha routes; minor capitalization change to 'Custom Agents'.
Skip to main content
August 13, 2026
Skip to main content
August 20, 2026
NOTION AGENT APIS IN PUBLIC BETA
The Notion Agent APIs are now in public beta. Use sessions to start a chat with a Custom Agent, stream its reply, submit an action, and page through a session's event history, so you can bring Custom Agents into a Slack bot, an internal tool, or a mobile client. The 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, and set credit limits, enable, disable, or delete agents — individually or in an asynchronous batch.If you built against the private alpha routes for agents, threads, messages, or chat, see Upgrading to public beta. The replacements take JSON request bodies instead of query parameters and return sessions and events instead of threads and messages. Migrate off the alpha routes by September 30, 2026.
August 13, 2026
Confidence95%
Full diff
=================================================================== --- before +++ after @@ -5,8 +5,14 @@ > Use this file to discover all available pages before exploring further. Skip to main content +August 20, 2026 + +NOTION AGENT APIS IN PUBLIC BETA + +The Notion Agent APIs are now in public beta. Use sessions to start a chat with a Custom Agent, stream its reply, submit an action, and page through a session’s event history, so you can bring Custom Agents into a Slack bot, an internal tool, or a mobile client. The 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, and set credit limits, enable, disable, or delete agents — individually or in an asynchronous batch.If you built against the private alpha routes for agents, threads, messages, or chat, see Upgrading to public beta. The replacements take JSON request bodies instead of query parameters and return sessions and events instead of threads and messages. Migrate off the alpha routes by September 30, 2026. + August 13, 2026 MORE FILTERS IN NOTION MCP VIEW TOOLS @@ -176,9 +182,9 @@ June 10, 2026 BOTS IN PEOPLE PROPERTIES AND USER MENTIONS -Bots that appear as user objects in API responses can now be assigned to people page property values and referenced in user rich text mentions. You can set a people property when you create a page or update page properties. Previously these writes returned a validation_error, even though the same bots were already returned when reading those fields. Some bots never appear as user objects, including integrations Notion uses internally to power features like database automations and custom agents. Assigning one of those still returns a validation_error. +Bots that appear as user objects in API responses can now be assigned to people page property values and referenced in user rich text mentions. You can set a people property when you create a page or update page properties. Previously these writes returned a validation_error, even though the same bots were already returned when reading those fields. Some bots never appear as user objects, including integrations Notion uses internally to power features like database automations and Custom Agents. Assigning one of those still returns a validation_error. June 8, 2026 UNIQUE ACCESS TOKENS PER OAUTH AUTHORIZATION
Get the next one in your inbox.
Follow the vendor for free, or write your own prompt and watch any page the same way.