> ## Documentation Index
> Fetch the complete documentation index at: https://docs.automate.ax/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Automate.ax automations are TypeScript programs.
> Use Bun for installation and command examples.
> Use Automate.ax for the product name and automate.ax for the package, CLI, and domain.
> Treat documented public APIs as current; do not invent transitional or deprecated names.

# Get Notion agent insights

> Retrieve usage and run insights for a Notion agent.

`notion.getAgentInsights` retrieve usage and run insights for a Notion agent.

## Example

```ts automations/notion-get-agent-insights.automation.ts theme={null}
import { automation, onSchedule } from "automate.ax"
import { notion } from "automate.ax/notion"

export default automation("Get Notion agent insights", () => {
  onSchedule({ schedule: "0 9 * * *" })

  notion.getAgentInsights({ agent_id: "agent-id" })
})
```

## Inputs

`agent_id` is required. Optional numeric `start_time` and `end_time` bound the provider time range. Every input accepts a compatible signal, and an optional second argument can select a named account.

## Output

Returns `agent_insights` with status, credit use and limit, completed runs, and creator visibility.