Read one trace for an agent

Read one trace for an agent

cURL

curl --request GET \
  --url https://agentgateway.atlan.engineering/agent/v1/agents/{agent_id}/traces/{trace_id} \
  --header 'Authorization: Bearer <token>'

200

{
  "is_complete": true,
  "started_at_unix_seconds": 123,
  "summary": {
    "error_count": 1,
    "span_count": 1,
    "input_tokens": 123,
    "output_tokens": 123,
    "total_cost_usd": 123,
    "total_tokens": 123
  },
  "trace_id": "<string>",
  "trace_status": "ok",
  "workspace_id": "<string>",
  "links": {
    "logs": "<string>",
    "spans": "<string>",
    "timeline": "<string>"
  },
  "attributes": "<unknown>",
  "duration_ms": 1,
  "ended_at_unix_seconds": 123,
  "match_confidence": "<string>",
  "metadata": "<unknown>",
  "models": [
    "<string>"
  ],
  "providers": [
    "<string>"
  ],
  "root_span_id": "<string>",
  "root_span_name": "<string>",
  "run_status": "<string>",
  "service_name": "<string>",
  "title": "<string>",
  "user_id": "<string>",
  "input": "<unknown>",
  "output": "<unknown>",
  "parent": {
    "is_available": true,
    "trace_id": "<string>",
    "confidence": "<string>",
    "identity_version": "<string>",
    "relationship": "<string>",
    "session_id": "<string>",
    "workspace_id": "<string>"
  }
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

agent_id · string · required

trace_id · string · required

Response

200

application/json

HTTP 200 response.

is_complete · boolean · required

started_at_unix_seconds · integer<int64> · required

summary · object · required

Show child attributes

trace_id · string · required

trace_status · enum<string> · required

Available options: ok, error, unset

workspace_id · string · required

links · object · required

Show child attributes

attributes · any

duration_ms · integer<int64> | null

Required range: x >= 0

ended_at_unix_seconds · integer<int64> | null

match_confidence · string | null

metadata · any

models · string[] | null

providers · string[] | null

root_span_id · string | null

root_span_name · string | null

run_status · string | null

service_name · string | null

title · string | null

user_id · string | null

input · any

output · any

parent · null | object

Show child attributes