Get usage metrics | Ara Documentation

Returns a usage time series, such as sandbox minutes and tokens per day.

_{Scope: analytics:read}

Authentication

AuthorizationBearer

Your ara_ API key from Settings > Ara API. Keys are capability-scoped: run, plugins:read, secrets:read, secrets:write, sessions:read, knowledge:read, repos:read, repos:write, reviews:read, reviews:write, analytics:read, org:read, org:write, attachments:read, attachments:write, plugins:write, guardrails:read, guardrails:write.

Path parameters

orgIdstringRequired

Organization id or slug. Resolve it with GET /v3/self.

Response

Usage time series.

itemslist of objects

1	{
2	"items": [
3	{
4	"date": "2024-04-20",
5	"sandbox_minutes": 135.5,
6	"tokens": 45230,
7	"sessions": 12
8	},
9	{
10	"date": "2024-04-21",
11	"sandbox_minutes": 98.75,
12	"tokens": 37840,
13	"sessions": 9
14	},
15	{
16	"date": "2024-04-22",
17	"sandbox_minutes": 120,
18	"tokens": 41000,
19	"sessions": 11
20	}
21	]
22	}

$	curl https://api.ara.so/v3/organizations/orgId/metrics/usage \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json"