v51

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

Timeline

Get a list of timeline analyses.

Retrieves a paginated list of activeflow AI analyses for the authenticated customer.

get/timeline-analyses

Query parameters

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.

activeflow_idstring uuid

Filter by the analyzed activeflow ID.

status'progressing' | 'completed' | 'failed'

Lifecycle state of the analysis.

Example:completed

Filter by analysis status.

Response

A list of timeline analyses.

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": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "customer_id": "7c4d2f3a-1b8e-4f5c-9a6d-3e2f1a0b4c5d",
      "activeflow_id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
      "status": "completed",
      "result": {
        "version": 1,
        "overall_status": "warning",
        "input_reduced": false,
        "narrative": "The call connected, the IVR collected the customer's intent, and the call was routed to an available agent who resolved the request.",
        "issues": [
          {
            "severity": "warning",
            "area": "routing",
            "summary": "The queue wait exceeded the configured target by 8 seconds.",
            "evidence": [
              {
                "evidence_index": 12,
                "event_type": "queue_joined",
                "timestamp": "2026-01-15T09:30:12.000000Z",
                "resource_id": "5e3f8b2a-9c1d-4e6f-8a7b-2d3c4e5f6a7b"
              }
            ]
          }
        ],
        "resources_used": [
          {
            "type": "call",
            "count": 1
          },
          {
            "type": "queuecall",
            "count": 1
          }
        ]
      },
      "error": "analysis engine timed out",
      "tm_create": "2026-01-15T09:30:00.000000Z",
      "tm_update": "2026-01-15T09:30:05.000000Z"
    }
  ]
}