Analytics API

Overview

The Analytics API aggregates LLM usage and product activity events into organization-scoped reports. It is gated to organization owners and admins and supports hourly, daily, weekly, and monthly granularity.

Base URL

https://api.allternit.com/api

All endpoints require a valid Bearer token in the Authorization header. See Authentication for details.

Endpoints

Method	Path	Description
POST	`/analytics/csp-violation`	Ingest a CSP violation report (stub).
POST	`/analytics/gizzi-code/events`	Ingest Gizzi Code CLI usage events.
GET	`/admin/analytics/cost-over-time`	Cost over time by granularity.
GET	`/admin/analytics/token-usage`	Token usage over time.
GET	`/admin/analytics/request-volume`	Request volume with status breakdown.
GET	`/admin/analytics/per-user-cost`	Cost per user.
GET	`/admin/analytics/active-users`	Daily active users and unique totals.
GET	`/admin/analytics/artifact-activity`	Artifact, revision, and section creation.
GET	`/admin/analytics/chat-project-usage`	Chat project and session creation.
GET	`/admin/analytics/connector-usage`	Connector connection activity.
GET	`/admin/analytics/plugin-usage`	Plugin invocations over time.
GET	`/admin/analytics/skill-usage`	Team skill installs and invocations.
GET	`/admin/analytics/gizzi-code/usage`	Gizzi Code CLI aggregated usage.

Query parameters

Most analytics endpoints accept:

Parameter	Type	Description
`organization_id`	string	Organization to query.
`start`	string	ISO 8601 start timestamp.
`end`	string	ISO 8601 end timestamp.
`granularity`	string	`hour`, `day`, `week`, or `month`. Default `day`.

Cost over time

GET /api/admin/analytics/cost-over-time?organization_id=org_abc123&start=2026-08-01T00:00:00Z&end=2026-08-03T00:00:00Z&granularity=day

Response:

{
  "items": [
    {
      "bucket": "2026-08-01",
      "cost_microdollars": 300000,
      "requests": 10
    },
    {
      "bucket": "2026-08-02",
      "cost_microdollars": 200000,
      "requests": 8
    }
  ]
}

Token usage

GET /api/admin/analytics/token-usage?organization_id=org_abc123&start=2026-08-01T00:00:00Z&end=2026-08-03T00:00:00Z&granularity=day

Response:

{
  "items": [
    {
      "bucket": "2026-08-01",
      "prompt_tokens": 1000,
      "completion_tokens": 500,
      "reasoning_tokens": 0,
      "cached_tokens": 0,
      "requests": 10
    }
  ]
}

Request volume

GET /api/admin/analytics/request-volume?organization_id=org_abc123&start=2026-08-01T00:00:00Z&end=2026-08-03T00:00:00Z&granularity=day

Response:

{
  "items": [
    {
      "bucket": "2026-08-01",
      "requests": 10,
      "ok": 9,
      "errors": 1,
      "budget_exceeded": 0,
      "rate_limited": 0,
      "dlp_blocked": 0
    }
  ]
}

Ingest Gizzi Code events

POST /api/analytics/gizzi-code/events

Request body:

{
  "events": [
    {
      "session_id": "sess_2f8a9c4e5d3b",
      "event_type": "turn",
      "model": "gizzi-pro",
      "provider": "allternit",
      "prompt_tokens": 100,
      "completion_tokens": 50,
      "cost_microdollars": 1000,
      "tool_calls_accepted": 2,
      "tool_calls_rejected": 0,
      "metadata": { "surface": "vscode" },
      "created_at": "2026-08-13T10:00:00Z"
    }
  ]
}

Response:

{ "status": "ok" }

Gizzi Code usage

GET /api/admin/analytics/gizzi-code/usage?organization_id=org_abc123&start=2026-08-01T00:00:00Z&end=2026-08-03T00:00:00Z&granularity=day

Response:

{
  "items": [
    {
      "bucket": "2026-08-01",
      "events": 100,
      "unique_users": 5,
      "unique_sessions": 20,
      "prompt_tokens": 50000,
      "completion_tokens": 25000,
      "cost_microdollars": 75000,
      "tool_calls_accepted": 80,
      "tool_calls_rejected": 5
    }
  ]
}

Error codes

Status	Code	Description
200	—	Success.
400	`invalid_range`	`start` must be before `end`.
401	`unauthorized`	Missing or invalid authentication.
403	`organization_required` / `insufficient_role`	Active organization and admin role required.
403	`organization_mismatch`	Requested organization does not match the active organization.
500	`internal_error`	Unexpected server error.

Overview

LLM Gateway

Agents & Runtime

Work Queue & Deployments

Files, Webhooks & Sandbox

Tools & Connectors

Collaboration & Workflows

Infrastructure & Platform

Canvases

Onboarding

A Labs

Playground

Users & Profiles

Overview

Base URL

Endpoints

Query parameters

Cost over time

Token usage

Request volume

Ingest Gizzi Code events

Gizzi Code usage

Error codes

​Overview

​Base URL

​Endpoints

​Query parameters

​Cost over time

​Token usage

​Request volume

​Ingest Gizzi Code events

​Gizzi Code usage

​Error codes

​Related links

Overview

Base URL

Endpoints

Query parameters

Cost over time

Token usage

Request volume

Ingest Gizzi Code events

Gizzi Code usage

Error codes

Related links