Sign in
latestOpenAPI 3.1.02026-08-21615231.2 MB

dee5763763b0

Agents

Get agent insights

get/v1/agents/{agent_id}/insights

Path parameters

string required
OR
'notion_ai' | '33333333-3333-3333-3333-333333333333' required

One of: notion_ai, 33333333-3333-3333-3333-333333333333

Query parameters

start_timeinteger

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.

end_timeinteger

End 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.

Headers

Notion-Version'2026-03-11' required

The API version to use for this request. The latest version is 2026-03-11.

Response

object'agent_insights' required

Always agent_insights

idstring uuid required
namestring required
agent_type'custom_agent' | 'autofill_custom_agent' required

One of: custom_agent, autofill_custom_agent

status'active' | 'disabled' | 'deleted' required

One of: active, disabled, deleted

pause_reason'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' nullable required

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

total_credits_usednumber required

Premium AI credits consumed by this agent within the window.

runs_completednumber required

Number of runs recorded for this agent within the window.