Sign in

v2

OpenAPI 3.0.02026-08-051996591.2 MB
Agent Analytics

Get agent trace

Returns the summary of a specific agent trace by its trace ID.

get/v2/agent_analytics/traces/{trace_id}

Path parameters

trace_idstring required
Example:0af7651916cd43dd8448eb211c80319c

The unique identifier of the trace.

Headers

Request-Timeoutinteger

The platform makes a best effort to complete the request in the specified seconds, or it times out.

Request-Timeout-Millisinteger

The platform makes a best effort to complete the request in the specified milliseconds, or it times out.

Response

The requested agent trace.

trace_idstring required

The unique identifier of the trace.

agent_keystring

A unique key that identifies an agent.

session_keystring

A unique key that identifies an agent session.

started_atstring date-time required

The time the trace started.

duration_msinteger

Total duration of the trace in milliseconds.

status'ok' | 'error' required

The final status of the trace.

input_tokensinteger

Total input tokens consumed across all spans.

output_tokensinteger

Total output tokens produced across all spans.

Example response

{
  "trace_id": "0af7651916cd43dd8448eb211c80319c",
  "agent_key": "customer_support",
  "session_key": "customer_support_chat"
}