Skip to main content
Traces are immutable logs of every decision, state change, or API call made within the system. They are crucial for compliance, debugging, and “Explainable AI”.

​
List Traces

​
session_id
string
Filter traces by session.
​
action
string
Filter by action type (e.g. state.update, memory.create, turn.add).
​
resource_type
string
Filter by affected resource (session, memory, turn).
curl "https://api.statebase.org/v1/traces?session_id=sess_123&action=state.update" \
  -H "Authorization: Bearer <token>"

​
Get Trace Details

Retrieves the full context (IP address, user agent, exact diff) of a specific trace.
​
trace_id
string
required
The ID of the trace.
curl https://api.statebase.org/v1/traces/trace_999... \
  -H "Authorization: Bearer <token>"