Ingest & observe — API reference

Send traces and read back sessions, conversations, agents, and the agent topology.

ingest

POST /ingest/batch

Ingest Batch

High-volume batch ingest: many raw sessions in one request.

POST /ingest/openinference

Ingest Openinference

POST /ingest/otlp

Ingest Otlp

POST /ingest/raw

Ingest Raw

POST /v1/traces

Otlp Traces

OTLP/HTTP trace receiver. Accepts protobuf or JSON; enqueues and returns an OTLP response.

traces

GET /agent-graph

Cohort Agent Graph

Cross-cohort aggregate agent/tool topology.

GET /sessions

List Sessions

GET /sessions/filter-options

Filter Options

GET /sessions/trend

Sessions Trend

Volume trend for the Traces page: per-day (or per-hour) trace counts, token usage (input and output), p50 latency and estimated spend over the selected time window, plus a period-over-period summary. Counts individual traces.

GET /sessions/{session_id}

Get Session

GET /sessions/{session_id}/agent-graph

Agent Graph

Aggregate agent/tool topology for one run.

POST /sessions/{session_id}/feedback

Submit Feedback

Record end-user feedback on a conversation — a CSAT rating or a thumbs up/down — without a helpdesk integration.

GET /sessions/{session_id}/similar

Similar Sessions

Sessions most similar to session_id (“more like this”), up to limit. Returns [] when similarity search is unavailable.

conversations

GET /conversations

List Conversations

GET /conversations/trend

Conversations Trend

Volume trend for the Sessions page: per-day (or per-hour) session counts, token usage (input and output), p50 latency and estimated spend over the selected time window, plus a period-over-period summary. Counts distinct sessions.

GET /conversations/{conversation_id}

Get Conversation

GET /conversations/{conversation_id}/agent-graph

Conversation Agent Graph

Aggregate agent/tool topology for a whole conversation.

POST /conversations/{conversation_id}/annotations

Add Conversation Annotation

Create one annotation (targetType ‘session’, targetId = member trace id) per member trace of the conversation, mirroring api/annotations.py’s contract + reviewer attribution. Returns the created count.

POST /conversations/{conversation_id}/labels

Add Conversation Label

Apply a tag to EVERY member trace of the conversation (idempotent, mirroring the single-trace POST /sessions/{id}/labels path). The written session_labels rows make the tag show up in the Sessions/Traces “Tags” filter. Returns the applied count.

agents

GET /agents

List Agents

labels

GET /labels

List Labels

POST /sessions/{session_id}/labels

Add Label

DELETE /sessions/{session_id}/labels/{label}

Remove Label

activity

GET /activity/runs

List Runs

GET /activity/trend

Activity Trend

Event-volume trend for the Activity page: per-day (or per-hour) count of activity runs over the selected window, plus a period-over-period total. Scoped to the current project like the feed. Queued-but-unstarted runs are excluded — they have no place on a time axis yet.

GET /eval-runs/{run_id}/metrics

Run Metrics

Real pipeline metrics for a score run, derived from activity_runs + eval_tasks (no synthetic data). run_id is the activity-run id (act_eval_{eval_run_id}).

stats

GET /stats

Get Stats

GET /stats/timeseries

Get Timeseries

overview

GET /overview/kpis

Overview Kpis

Hero KPI row: spine counts + scope-wide trace/session/error/spend totals + deltas.

GET /overview/segments

Overview Segments

Segmentation table: scope sliced by org | project | agent.

GET /overview/timeseries

Overview Timeseries

Tenant trends: per-day traces / sessions / errors / eval pass-rate / spend over the range.