Create Trace

Start a new trace for agent execution

POST /v1/traces

cURL

curl -X POST https://api.playgent.com/v1/traces \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "agent_abc123",
    "run_id": "run_def456",
    "input": {
      "messages": [{ "role": "user", "content": "What is your refund policy?" }]
    },
    "metadata": {
      "session_id": "sess_123",
      "user_id": "user_456"
    }
  }'

Response

{
  "trace_id": "trace_ghi789",
  "root_span_id": "span_jkl012"
}

Start a new trace to capture detailed execution spans. Called by the SDK at agent invocation start.

agent_id · string · required

Agent being traced

run_id · string

Link trace to a test run (optional)

input · object · required

Initial input to the agent

Show properties

messages · array

Input messages

metadata · object

Additional metadata

Show properties

session_id · string

Session identifier

user_id · string

User identifier

trace_id · string · required

Unique trace identifier

root_span_id · string · required

Root span identifier for the trace

cURL

curl -X POST https://api.playgent.com/v1/traces \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "agent_abc123",
    "run_id": "run_def456",
    "input": {
      "messages": [{ "role": "user", "content": "What is your refund policy?" }]
    },
    "metadata": {
      "session_id": "sess_123",
      "user_id": "user_456"
    }
  }'

Response

{
  "trace_id": "trace_ghi789",
  "root_span_id": "span_jkl012"
}