List conversation workflow executions

curl --request GET \
  --url https://api.kapso.ai/platform/v1/whatsapp/conversations/{conversation_id}/flow_executions \
  --header 'X-API-Key: <api-key>'

{
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "status": "running",
      "tracking_id": "8b1c9d2e-3f4a-5b6c-7d8e-9f0a1b2c3d4e",
      "whatsapp_conversation_id": "8c9c7a6b-5d4e-3f2a-1b0c-9d8e7f6a5b4c",
      "started_at": "2025-12-05T17:20:00Z",
      "last_event_at": "2025-12-05T17:25:00Z",
      "ended_at": null,
      "workflow": {
        "id": "flow_789",
        "name": "Order Support",
        "status": "active"
      },
      "current_step": {
        "identifier": "wait_response",
        "stepable_type": "FlowWaitStep"
      }
    }
  ],
  "meta": {
    "page": 1,
    "per_page": 20,
    "total_pages": 1,
    "total_count": 1
  }
}

WhatsApp Conversations

List conversation workflow executions

Retrieve workflow executions associated with a WhatsApp conversation. Executions are returned in reverse chronological order (most recent first).

Use this endpoint to map a conversation to its workflow executions and track automation history for a specific conversation.

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

Pagination: Available in both HTTP headers (X-Total, X-Total-Pages, X-Per-Page, X-Page, Link) and response body (meta object with page, per_page, total_pages, total_count).

GET

conversations

{conversation_id}

flow_executions

List conversation workflow executions

curl --request GET \
  --url https://api.kapso.ai/platform/v1/whatsapp/conversations/{conversation_id}/flow_executions \
  --header 'X-API-Key: <api-key>'

{
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "status": "running",
      "tracking_id": "8b1c9d2e-3f4a-5b6c-7d8e-9f0a1b2c3d4e",
      "whatsapp_conversation_id": "8c9c7a6b-5d4e-3f2a-1b0c-9d8e7f6a5b4c",
      "started_at": "2025-12-05T17:20:00Z",
      "last_event_at": "2025-12-05T17:25:00Z",
      "ended_at": null,
      "workflow": {
        "id": "flow_789",
        "name": "Order Support",
        "status": "active"
      },
      "current_step": {
        "identifier": "wait_response",
        "stepable_type": "FlowWaitStep"
      }
    }
  ],
  "meta": {
    "page": 1,
    "per_page": 20,
    "total_pages": 1,
    "total_count": 1
  }
}

Authorizations

X-API-Key

string

header

required

Path Parameters

conversation_id

string<uuid>

required

WhatsApp conversation identifier

Query Parameters

status

enum<string>

Filter by execution status

Available options:

running,

waiting,

ended,

failed,

handoff

per_page

integer

default:20

Number of results per page

Required range: 1 <= x <= 100

page

integer

default:1

Page number for pagination

Required range: x >= 1

Response

Executions retrieved successfully

List of workflow executions with pagination metadata

data

object[]

required

Show child attributes

data.id

string<uuid>

required

Unique execution identifier

data.status

enum<string>

required

Execution status:

running: Currently executing workflow steps
waiting: Paused, awaiting user input or timeout
ended: Successfully completed
failed: Terminated due to error
handoff: Transferred to human agent

Available options:

running,

waiting,

ended,

failed,

handoff

data.started_at

string<date-time>

required

Execution start timestamp

data.last_event_at

string<date-time>

required

Timestamp of most recent workflow event or activity

data.ended_at

string<date-time> | null

Execution completion timestamp, null if still active

data.tracking_id

string<uuid> | null

Optional external tracking identifier for correlating with external systems

data.whatsapp_conversation_id

string<uuid> | null

Associated WhatsApp conversation identifier, links execution to its conversation

data.workflow

object

Compact workflow reference used in execution objects

Show child attributes

data.workflow.id

string<uuid>

required

Workflow identifier

data.workflow.name

string

required

Workflow name

data.workflow.status

string

required

Workflow status

data.current_step

object

Reference to a workflow step (used in execution current_step tracking)

Show child attributes

data.current_step.id

string<uuid>

required

Database ID of the workflow step

data.current_step.identifier

string

required

Step identifier within the workflow (e.g., 'start', 'step1', 'agent_greeting')

data.current_step.stepable_type

string | null

Ruby class name of the step type (e.g., 'FlowAgentStep', 'FlowActionStep', 'FlowWaitStep', 'FlowDecideStep')

data.current_step.position

object

Canvas position for visual editor

Show child attributes

data.current_step.position.x

number

data.current_step.position.y

number

Getting started

Workflows

Voice Agents

Functions

Workflows

Workflow Triggers

Voice Agents

Functions

WhatsApp Conversations

List conversation workflow executions

Authorizations

Path Parameters

Query Parameters

Response