Analytics APIAnalytics SaaS

Usage

View as Markdown
Daily usage series for the workspace over **`dateFrom`–`dateTo`** (inclusive calendar days). **At most one** of `agentId`, `memberId`, `departmentId` may be set → `40020` if more than one. **Success `data`:** `{ "period", "series": [{ "date", "requests", "cost", "tokens" }] }` — `cost` is USD float from storage units.

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

dateFromstringRequired

Inclusive start YYYY-MM-DD (UTC calendar).

dateTostringRequired

Inclusive end YYYY-MM-DD.

agentIdstringOptional
Optional agent UUID filter.
memberIdstringOptional

Optional member/user UUID filter.

departmentIdstringOptional
Optional department UUID filter.

Response

codeinteger
messagestring
dataany