GET
/
api
/
v1
/
workflow
/
{workflowId}
/
executions
List workflow executions
curl --request GET \
  --url https://prod.featherhq.com/api/v1/workflow/{workflowId}/executions \
  --header 'X-API-Key: <api-key>'
{
  "executions": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "workflowId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "status": "CREATED",
      "temporalWorkflowId": "<string>",
      "startedAt": "<string>",
      "completedAt": "<string>",
      "customerLeadId": "<string>",
      "metadata": {
        "firstName": "<string>",
        "lastName": "<string>"
      },
      "disposition": "NO_ANSWER",
      "definition": {
        "steps": [
          {
            "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "type": "CALL",
            "order": 2,
            "delayInSecs": 0,
            "needsTCPACompliance": true,
            "finishOn": [],
            "agentId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "leaveVoicemail": false,
            "conditions": []
          }
        ]
      },
      "stepExecutions": [
        {
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "workflowExecutionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "status": "PENDING",
          "type": "CALL",
          "order": 123,
          "delayInSecs": 123,
          "needsTCPACompliance": true,
          "finishOn": [
            "NO_ANSWER"
          ],
          "startedAt": "<string>",
          "completedAt": "<string>",
          "leaveVoicemail": true,
          "disposition": "NO_ANSWER",
          "agentId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "agentCall": {
            "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "status": "<string>",
            "callStartedAt": "<string>",
            "callEndedAt": "<string>",
            "callDuration": 123,
            "callEndedReason": "NO_ANSWER",
            "recordingUrl": "<string>",
            "summary": "<string>"
          }
        }
      ],
      "createdAt": "<string>"
    }
  ],
  "pagination": {
    "limit": 10,
    "nextCursor": "<string>"
  }
}

Authorizations

X-API-Key
string
header
required

Path Parameters

workflowId
string<uuid>
required

Query Parameters

status
enum<string>

Filter by execution status

Available options:
CREATED,
RUNNING,
COMPLETED,
FAILED,
CANCELLED,
PAUSED
customerLeadId
string

Filter by customer lead ID

cursor
string
limit
string
default:10

Response

200
application/json

Agent workflow executions retrieved successfully

The response is of type object.