Sign in
latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-205391153.1 KB

4a74befa0bde

runs

List a session's events

Returns the paginated event trace for a session (workflow runs and workflow-less interactive leases alike). Org-scoped: another org's session reads as not found. A trace past the organization's telemetry retention window returns an empty list with retention_expired=true; when the retention policy itself cannot be resolved the request fails with a 500 rather than serving events whose retention state is unknown.

get/phones/sessions/{session_id}/events

Path parameters

session_idstring required

Session whose events to return.

Session whose events to return.

Query parameters

event_typesstring[] nullable

Restrict results to specific event type codes (RUN_STARTED / OUTPUT_LOG / SDK_CALL_COMPLETED / etc.).

Restrict results to specific event type codes (RUN_STARTED / OUTPUT_LOG / SDK_CALL_COMPLETED / etc.).

limitinteger

Maximum number of events to return (1-1000).

Maximum number of events to return (1-1000).

offsetinteger

Pagination offset.

Pagination offset.

Response

OK

$schemastring uri

A URL to the JSON Schema for this object.

inference_costsobject required

Billed microdollars per inference_id.

limitinteger required

Page size used for this response.

offsetinteger required

Pagination offset used for this response.

retention_expiredboolean required

True when the trace is past the org's retention window. Events are withheld from this point on, and the underlying data is physically deleted by a daily sweep; deletion may lag this flag by up to a day, after which the data is unrecoverable.

sdk_call_costsobject required

Billed microdollars per SDK-call span_id.

totalinteger required

Total number of events matching the query.

Example response

{
  "$schema": "/api/v1/RunEventsResponse.json"
}