Skip to main content
POST
Start a new execution trace

Authorizations

Authorization
string
header
required

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

Body

application/json
agent_id
string
required
agent_name
string
trigger
string
metadata
object
idempotency_key
string

Retries with the same tenant, agent, and key return the stored execution.

started_at
string<date-time>

Optional captured start time for offline delivery. Defaults to server time. Stored at microsecond precision; explicit retries must use the same time.

Response

Execution created

id
string
agent_id
string
agent_name
string
status
enum<string>
Available options:
RUNNING,
COMPLETED,
FAILED,
CANCELLED
root_span_id
string
trigger
string
started_at
string<date-time>
ended_at
string<date-time>
metadata
object
created_at
string<date-time>