Base URL
Create Session
string
required
Descriptive name for the session.
string
required
Agent identifier for grouping.
string
required
External user identifier.
object
Custom key-value data.
Request
Response
cURL Example
Update Session
string
"completed" or "failed".boolean
Whether session completed successfully.
string
Reason for failure if
success=false.number
Total cost in USD.
number
Duration in milliseconds.
number
Input tokens used.
number
Output tokens used.
number
Total tokens.
object
Custom numeric metrics.
Request
Response
cURL Example
Error Codes
Next Steps
Events API
Track events within sessions.
Python SDK
Use the SDK for easier integration.

