Record Trace

Create or update a trace within a session. Use to group related completions in agent workflows. See SDK method.

Generate the trace_id client-side (UUID v4) to avoid round-trip latency.

POST /api/v2/projects/{project_id}/sessions/{session_id}/traces/id/{trace_id}

Record Trace

cURL

curl --request POST \
  --url https://api.example.com/api/v2/projects/{project_id}/sessions/{session_id}/traces/id/{trace_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "input": true,
  "output": true,
  "parent_id": null,
  "test_run_info": {
    "test_run_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "test_case_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  },
  "agent_name": null,
  "custom_metadata": null,
  "eval_results": null,
  "name": null,
  "kind": null,
  "start_time": null,
  "end_time": null
}
'

201

{}

Authorizations

Authorization · string · header · required

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

Path Parameters

project_id · string · required

session_id · string · required

trace_id · string · required

Body

application/json

input · boolean integer number string object any[] · required

output · boolean integer number string object any[] · required

parent_id · string<uuid> | null

test_run_info · TestRunInfo · object | null

Show child attributes

agent_name · string | null

custom_metadata · Custom Metadata · object | null

Show child attributes

eval_results · Eval Results · object | null

Show child attributes

name · string | null

kind · string | null

Allowed value: "tool"

start_time · string<date-time> | null

end_time · string<date-time> | null

Response

201 - application/json

EmptyResponse()

The response is of type EmptyResponse · object.