Update Span

Complete a span with output and metrics

PATCH /v1/spans/{span_id}

cURL

curl -X PATCH https://api.playgent.com/v1/spans/span_mno345 \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "output": {
      "content": "Our refund policy allows returns within 30 days...",
      "tool_calls": []
    },
    "end_time": "2024-12-16T10:00:02.456Z",
    "tokens_input": 234,
    "tokens_output": 156,
    "cost_usd": 0.0089,
    "status": "completed"
  }'

Response

{
  "span_id": "span_mno345",
  "duration_ms": 2333
}

Update a span with its output, timing, and metrics after the operation completes.

span_id · string · required

Span identifier

output · object · required

Span output data

Show properties

content · string

For LLM spans: response content

tool_calls · array

For LLM spans: tool calls made

documents · array

For retrieval spans: retrieved documents

result · any

For tool spans: tool result

end_time · string · required

ISO 8601 timestamp when span completed

tokens_input · integer

Input tokens used (LLM spans)

tokens_output · integer

Output tokens generated (LLM spans)

cost_usd · number

Estimated cost in USD

status · string · required

Span status: completed or error

error_message · string

Error message if status is error

span_id · string · required

Updated span identifier

duration_ms · integer · required

Calculated duration in milliseconds

cURL

curl -X PATCH https://api.playgent.com/v1/spans/span_mno345 \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "output": {
      "content": "Our refund policy allows returns within 30 days...",
      "tool_calls": []
    },
    "end_time": "2024-12-16T10:00:02.456Z",
    "tokens_input": 234,
    "tokens_output": 156,
    "cost_usd": 0.0089,
    "status": "completed"
  }'

Response

{
  "span_id": "span_mno345",
  "duration_ms": 2333
}