Skip to main content
POST
/
api
/
v1
/
internal
/
traces
Ingest Trace Route
curl --request POST \
  --url https://api.example.com/api/v1/internal/traces \
  --header 'Content-Type: application/json' \
  --data '
{
  "trace_id": "<string>",
  "proxy_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "org_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "provider": "<string>",
  "model": "<string>",
  "timestamp": "2023-11-07T05:31:56Z",
  "session_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "request_tokens": 0,
  "response_tokens": 0,
  "latency_ms": 0,
  "policy_decision": "",
  "policy_rule": "",
  "response_body": "",
  "intent_score": 0.5,
  "intent_action": "<string>",
  "integration_names": "",
  "stream": 0,
  "status_code": 200
}
'
{
  "trace_id": "<string>",
  "proxy_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "org_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "provider": "<string>",
  "model": "<string>",
  "request_tokens": 123,
  "response_tokens": 123,
  "latency_ms": 123,
  "policy_decision": "<string>",
  "intent_score": 123,
  "intent_action": "<string>",
  "integration_names": "<string>",
  "stream": 123,
  "status_code": 123,
  "timestamp": "2023-11-07T05:31:56Z",
  "tool_names": "<string>",
  "session_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "policy_rule": "",
  "response_body": ""
}

Headers

​
Authorization
string | null

Body

application/json
​
trace_id
string
required
Required string length: 1 - 255
​
proxy_id
string<uuid>
required
​
org_id
string<uuid>
required
​
provider
string
required
Maximum string length: 128
​
model
string
required
Required string length: 1 - 255
​
timestamp
string<date-time>
required
​
session_id
string<uuid> | null
​
request_tokens
integer
default:0
Required range: 0 <= x <= 4294967295
​
response_tokens
integer
default:0
Required range: 0 <= x <= 4294967295
​
latency_ms
integer
default:0
Required range: 0 <= x <= 4294967295
​
policy_decision
string
default:""
Maximum string length: 64
​
policy_rule
string
default:""
Maximum string length: 255
​
response_body
string
default:""
Maximum string length: 4096
​
intent_score
number | null
Required range: 0 <= x <= 1
​
intent_action
string | null
Maximum string length: 64
​
integration_names
string
default:""
Maximum string length: 1024
​
stream
integer
default:0
Required range: 0 <= x <= 1
​
status_code
integer
default:200
Required range: 100 <= x <= 599

Response

Successful Response

​
trace_id
string
required
​
proxy_id
string<uuid>
required
​
org_id
string<uuid>
required
​
provider
string
required
​
model
string
required
​
request_tokens
integer
required
​
response_tokens
integer
required
​
latency_ms
integer
required
​
policy_decision
string
required
​
intent_score
number | null
required
​
intent_action
string | null
required
​
integration_names
string
required
​
stream
integer
required
​
status_code
integer
required
​
timestamp
string<date-time>
required
​
tool_names
string
required

Compatibility alias for runtimes still reading tool_names.

​
session_id
string<uuid> | null
​
policy_rule
string
default:""
​
response_body
string
default:""