Inspect Campaign Execution

Retrieve a bounded diagnostic view of one campaign execution. The response contains execution state, minimal contact identity, recent steps, and sanitized failure details without message bodies, provider credentials, internal payloads, or stack traces.

GET
/v1/campaigns/:campaign/executions/:execution

Retrieve execution diagnostics for a campaign

Path parameters

campaignstring Required

Campaign UUID

executionstring Required

Execution UUID belonging to the campaign

Request body

step_limitnumber

Number of recent steps to return. Defaults to `25` and has a maximum of `25`.

Request
cURL
curl "https://api.leadpush.io/v1/campaigns/:campaign/executions/:execution?step_limit=10" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {token}"
Response Example
{
  "data": {
    "execution": {
      "uuid": "<execution_uuid>",
      "status": "failed",
      "campaign_uuid": "<campaign_uuid>",
      "campaign_version_uuid": "<campaign_version_uuid>",
      "campaign_version_number": 3,
      "started_at": "2026-10-07T13:00:00.000000Z",
      "completed_at": "2026-10-07T13:01:20.000000Z",
      "last_step_at": "2026-10-07T13:01:20.000000Z",
      "current_or_failed_node_id": 12
    },
    "contact": {
      "uuid": "<contact_uuid>",
      "email": "person@example.com",
      "first_name": "Avery",
      "last_name": "Lee"
    },
    "recent_steps": [
      {
        "uuid": "<step_uuid>",
        "node_id": 12,
        "output_handle": null,
        "entered_at": "2026-10-07T13:01:18.000000Z",
        "exited_at": "2026-10-07T13:01:20.000000Z",
        "failed": true,
        "completed": false
      }
    ],
    "error": {
      "category": "ProviderException",
      "message": "The provider rejected the request."
    }
  }
}

Diagnostic Boundaries

Sensitive data intentionally excluded from execution diagnostics

  • Step history is limited to the most recent 25 entries.
  • Error messages are sanitized and limited in length.
  • Raw message bodies, provider credentials, internal payloads, and stack traces are not returned.
  • The campaign and execution must both belong to the API key's workspace.