Retrieve agent insights
Retrieve configuration and usage insights for a Custom Agent.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Headers
The API version to use for this request. The latest version is 2026-03-11.
2026-03-11 Path Parameters
The agent ID (a UUID), or notion_ai for the personal agent. Endpoint-specific restrictions still apply.
Query Parameters
Start of the insights window, as an epoch timestamp in seconds. Must be supplied together with end_time; if either is omitted the window defaults to the current billing period.
x >= 0End of the insights window, as an epoch timestamp in seconds. Must be supplied together with start_time; if either is omitted the window defaults to the current billing period.
x >= 0Response
Always agent_insights
"agent_insights"One of: custom_agent, autofill_custom_agent
custom_agent, autofill_custom_agent One of: active, disabled, deleted
active, disabled, deleted One of: run_limit, credit_limit, runaway_credit_usage, workspace_credit_limit, failure_limit, mark_session_failed_autopause, disabled_from_workspace_settings, 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
run_limit, credit_limit, runaway_credit_usage, workspace_credit_limit, failure_limit, mark_session_failed_autopause, disabled_from_workspace_settings, 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 Premium AI credits consumed by this agent within the window.
Enforced per-agent credit limit; null when none is configured, and "hidden" when the caller lacks full access to the agent.
Number of runs recorded for this agent within the window.