apiwatch

All changes / Notion

Deprecation rest

Two Notion Admin API list endpoints now honor start_cursor; the cursor parameter is deprecated, and sending both with different values returns 400

Took effect · Admin API List MCP client connections (GET /v1/mcp_client_connections) and List personal access tokens (GET /v1/spaces/{space_id}/personal_access_tokens) — pagination parameter

Reviewed against the vendor source on Oct 12, 2026 (AI-assisted review). Key facts are re-checked against the source daily.

What changes

As of October 9, 2026, List MCP client connections and List personal access tokens accept start_cursor, like other Admin API list endpoints. Before, these endpoints ignored start_cursor and returned the first page again, so code paginating with start_cursor saw the first page repeated. The cursor parameter still works but is deprecated (the API reference marks it "Deprecated; use start_cursor"); no removal date has been announced. A request that sends both cursor and start_cursor with different values fails with a 400 error.

Deprecation: Still works; removal is announced.

What to do

Paginate these endpoints with start_cursor set to the previous response's next_cursor, and stop sending cursor. Never send both parameters. Remove any workaround that compensated for start_cursor returning the first page again.

Strings to search for

/v1/mcp_client_connections/personal_access_tokens

Counts only in files that mention notion + cursor + /v1/mcp_client_connections or notion + cursor + /spaces/.

Source

https://developers.notion.com/page/changelog