Skip to main content

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.