Analytics API

Query agent runs, action invocations, approval decisions and usage.

Use these endpoints to inspect agents, action invocations, approval decisions and usage from one analytics surface.

Authentication

All endpoints use API key auth, and the key needs analytics:read:

curl https://api.anlyon.com/api/v2/analytics/trust-control \
  -H "Authorization: Bearer anlyon_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

Endpoints

Method	Endpoint	Notes
`GET`	`/api/v2/analytics/overview`	Summary figures, usage, and attention signals
`GET`	`/api/v2/analytics/agents`	Agent run outcomes, latency, tokens, and cost
`GET`	`/api/v2/analytics/trust-control`	Action invocation and approval decision analytics
`GET`	`/api/v2/analytics/usage/current`	Current usage snapshot
`GET`	`/api/v2/analytics/usage/history`	Usage history over date range
`GET`	`/api/v2/analytics/errors`	Error distribution (`limit`)
`GET`	`/api/v2/analytics/onboarding`	Workspace onboarding status

Common query parameters

The following are supported where date filtering is available:

startDate (ISO 8601)
endDate (ISO 8601)
granularity (hour, day, week, month)
limit for /errors

The four product analytics endpoints support all parameters above, plus environmentId. Session-authenticated dashboard requests can select an environment or query the whole workspace. API keys and OAuth tokens always remain restricted to their bound environment.

Examples

Product overview

curl "https://api.anlyon.com/api/v2/analytics/overview?startDate=2026-07-01T00:00:00Z&endDate=2026-07-19T00:00:00Z&granularity=day" \
  -H "Authorization: Bearer anlyon_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

Usage history

curl "https://api.anlyon.com/api/v2/analytics/usage/history?startDate=2025-01-01T00:00:00Z&endDate=2025-01-31T23:59:59Z" \
  -H "Authorization: Bearer anlyon_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

Error distribution

curl "https://api.anlyon.com/api/v2/analytics/errors?startDate=2025-01-01T00:00:00Z&endDate=2025-01-31T23:59:59Z&limit=10" \
  -H "Authorization: Bearer anlyon_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

Notes

Date filters are optional. When you leave them out, the API applies its defaults.
Product analytics responses include range and scope metadata. range.truncated is true when the requested start date is older than the workspace plan’s analytics retention window.
Metered product usage is workspace-wide and is labeled as such. Environment-scoped products are filtered by environmentId.
Responses include success and data, and many endpoints also include charts payloads for dashboard visualization.