Skip to main content
POST
Report run telemetry

Authorizations

Authorization
string
header
required

User PAT (cliq_tok_…, including session-scoped) or realm token (cliq_dt_…).

Body

application/json
kind
enum<string>
required

Usage snapshot ingest

Available options:
usage
snapshot_type
enum<string>
required

Phase-level or run-level snapshot

Available options:
phase,
run
run_id
string
required

Run id the snapshot belongs to

Minimum string length: 1
total_tokens_in
number
required

Total input tokens

total_tokens_out
number
required

Total output tokens

total_duration_ms
number
required

Total duration in milliseconds

total_llm_calls
number
required

Total LLM calls

total_invocations
number
required

Total tool/agent invocations

phase
string

Phase name when snapshot_type is phase

by_phase
object

Per-phase breakdown

by_agent
object

Per-agent breakdown

by_model
object

Per-model breakdown

Response

true for usage; { inserted, received } for traces.

ok
enum<boolean>
required

Always true on success.

Available options:
true
data
required
Available options:
true