Analytics SDKAnalytics APIAnalytics Atomic

Get Usage Timeseries

View as Markdown
Time series for one metric; buckets are **days** or **hours**. **Required:** `metric`. **Optional:** `granularity` (`day` default, or `hour`), plus date window (see query params). **Constraint:** `granularity=hour` does **not** support `success_rate` or `latency` → HTTP 400 / `40010`. **Success `data`:** `{ "granularity", "metric", "window", "points": [{ "bucket", "value" }] }`

Headers

AuthorizationstringOptional

Optional. Bearer JWT, Virtual Key, or PAT. Server also accepts Cookie alephant_token; not modeled as a header here.

X-Workspace-IdstringOptional

Optional in the spec; required for authenticated analytics. Omit for unauthenticated GET /v1/analytics/health.

Query parameters

metricstringRequired

One of cost, requests, tokens, avg_cost_per_req, success_rate, latency.

granularitystringOptional

day (default) or hour.

presetstringOptional

Same allowed values as usage summary; default 30d when no explicit start and end.

startstringOptional

YYYY-MM-DD, paired with end.

endstringOptional

YYYY-MM-DD, paired with start.

Response

codeinteger
messagestring
dataany