Agents
Retrieve agent insights
Retrieve configuration and usage insights for a Custom Agent or the authenticated user’s personal agent.
GET
TypeScript SDK
Personal agent insights
Passnotion_ai as the agent_id to read insights for the personal agent (Notion AI) instead of a Custom Agent. The response keeps the same agent_insights shape, with a few differences:
idandagent_typeare bothnotion_ai.created_byis the user the token acts as.statusis alwaysactiveandpause_reasonis alwaysnull, because the personal agent has no per-agent status controls.credit_limitreports the member credit limit that applies to the token’s user, ornullwhen none applies.
AccessOnly a personal access token can read personal agent insights, and the totals always cover the user that token acts as, never another member’s usage. Any other token receives a
404 object_not_found.Authorizations
Headers
The API version to use for this request. The latest version is 2026-03-11.
Available options:
2026-03-11 Path Parameters
Query Parameters
Response
One of: run_limit, credit_limit, runaway_credit_usage, workspace_credit_limit, owner_allowance_limit, failure_limit, mark_session_failed_autopause, disabled_from_workspace_settings, disabled_from_workspace_settings_but_resumable, disabled_from_api, disabled_from_agent_settings, disabled_due_to_no_members_with_access, disabled_due_to_lack_of_editors, disabled_by_notion, internal_error, needs_user_review, tool_unavailable
Available options:
run_limit, credit_limit, runaway_credit_usage, workspace_credit_limit, owner_allowance_limit, failure_limit, mark_session_failed_autopause, disabled_from_workspace_settings, disabled_from_workspace_settings_but_resumable, disabled_from_api, disabled_from_agent_settings, disabled_due_to_no_members_with_access, disabled_due_to_lack_of_editors, disabled_by_notion, internal_error, needs_user_review, tool_unavailable