v51

latestOpenAPI 3.0.0raw.githubusercontent.com2026-08-014102371.0 MB

Timeline

Get aggregated timeline events

Returns all timeline events associated with a single activeflow execution. Query by activeflow_id directly, or by call_id (which resolves to the call's activeflow). Exactly one of activeflow_id or call_id must be provided.

get/aggregated-events

Query parameters

activeflow_idstring uuid

Example:550e8400-e29b-41d4-a716-446655440000

The UUID of the activeflow. Obtained from the id field of GET /activeflows or from the activeflow_id field of a call.

call_idstring uuid

Example:a1b2c3d4-e5f6-7890-abcd-ef1234567890

The UUID of the call. Obtained from the id field of GET /calls. The call's activeflow_id will be used to query events.

page_sizeinteger

Example:25

Number of results to return per page.

page_tokenstring

Cursor token for pagination. Use the next_page_token value from the previous response.

Response

A list of aggregated timeline events sorted by timestamp descending.

next_page_tokenstring

Cursor token for the next page of results. Pass this value as the page_token parameter in the next request.

Example response

{
  "result": [
    {
      "timestamp": "2026-01-15T09:30:00.000000Z",
      "event_type": "call_created",
      "data": {}
    }
  ]
}