traces

One agent session: its turns, and every span inside them.

A trace outside the scope is a 404. Without workspace_id, an id in more than one of the caller's workspaces is a 409 rather than a guess.

get/api/v1/traces/{trace_id}

Request

  • The document declares no server URL.
  • Auth: one of:
    • API key in header Otari-Key
    • API key in header x-api-key

Path parameters

trace_idstring required

Query parameters

workspace_idstring uuid nullable

The workspace the trace is in, as its list entry names it.

Response

Successful Response

state'active' | 'idle' required
truncatedboolean required

True when the session holds more spans than one read returns.

Changes