Sign in

v1

latestOpenAPI 3.1.02026-07-22115189303.8 KB
Workflows

List workflow executions

Retrieve execution history for a workflow. Executions are returned in reverse chronological order (most recent first). Use query parameters to filter by status, time range, or cursor.

Response: Returns summary data (id, status, tracking_id, timestamps, workflow, current_step). Does not include execution_context or events. Use GET /workflow_executions/{id} to retrieve full execution details.

Pagination: Use limit, after, and before. Pagination cursors are returned in the paging object.

Common use cases:

  • Monitor active executions for a workflow
  • Review failed executions for debugging
  • Audit execution history over time
  • Find waiting executions that need user input
get/workflows/{workflow_id}/executions

Query parameters

status'running' | 'waiting' | 'ended' | 'failed' | 'handoff'

Filter by execution status

waiting_reasonstring

Filter waiting executions by reason (e.g., 'wait_for_response', 'timeout')

created_afterstring date-time

Only return executions started on or after this timestamp

created_beforestring date-time

Only return executions started on or before this timestamp

whatsapp_conversation_idstring uuid

Filter by associated WhatsApp conversation

limitinteger

Maximum number of results per cursor-paginated page (default 20, max 100).

beforestring

Cursor for the previous page (Base64 encoded).

afterstring

Cursor for the next page (Base64 encoded).

Response

Executions retrieved successfully