---
title: TriggerResponse schema
description: Fields of the TriggerResponse object in the Cascades API.
canonical_url: "https://cascades.crscreditapi.com/docs/api/schemas/TriggerResponse"
doc_version: "1.0.0"
last_updated: "2026-10-09T18:04:24Z"
source: "public/api-docs/v1/swagger.yaml#/components/schemas/TriggerResponse"
---

# TriggerResponse

Defined in [openapi.json](https://cascades.crscreditapi.com/openapi.json#/components/schemas/TriggerResponse) ([YAML](https://cascades.crscreditapi.com/openapi.yaml)).

| Field | Type | Required | Description |
|---|---|---|---|
| `data` | ExecutionSummary | no | The shape returned by `triggerWorkflow`. Compared with `Execution` it carries `execution_mode` and never `assigned_to_user_id`. |
|   `id` | integer | yes |  |
|   `object` | string | yes |  |
|   `workflow_id` | integer | yes |  |
|   `status` | string | yes | Lifecycle of an execution. `queued` (batch rows not yet dispatched), `pending`, `running` and `waiting` (paused on a Wait node or adverse-action waiting period) are in flight; `awaiting_review` is paused on human review; `completed`, `failed`, `cancelled` and `skipped` are terminal. One of: `"queued"`, `"pending"`, `"running"`, `"waiting"`, `"awaiting_review"`, `"completed"`, `"failed"`, `"cancelled"`, `"skipped"`. |
|   `execution_mode` | string | no |  One of: `"test"`, `"live"`. |
| &nbsp;&nbsp;`execution_key` | string, nullable | no | The namespaced idempotency key (`api_client:<id>:<Idempotency-Key>`). |
| &nbsp;&nbsp;`external_reference` | string, nullable | no |  |
| &nbsp;&nbsp;`needs_human_review` | boolean | yes |  |
| &nbsp;&nbsp;`review_status` | string | yes |  One of: `"none"`, `"in_review"`, `"approved"`, `"denied"`. |
| &nbsp;&nbsp;`started_at` | string (date-time), nullable | no |  |
| &nbsp;&nbsp;`completed_at` | string (date-time), nullable | no |  |
| &nbsp;&nbsp;`created_at` | string (date-time) | yes |  |
| &nbsp;&nbsp;`updated_at` | string (date-time), nullable | no |  |
| `meta` | Meta | no |  |
| &nbsp;&nbsp;`request_id` | string | yes | Correlation id for this request. Also sent as the `X-Request-Id` response header; quote it when contacting support. |

```json
{
  "data": {
    "id": 1842,
    "object": "execution",
    "workflow_id": 27,
    "status": "queued",
    "execution_mode": "test",
    "execution_key": "api_client:12:3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "external_reference": "rv-app-20491",
    "needs_human_review": true,
    "review_status": "none",
    "started_at": "2026-05-08T18:41:05Z",
    "completed_at": "2026-05-08T18:41:05Z",
    "created_at": "2026-05-08T18:41:05Z",
    "updated_at": "2026-05-08T18:41:05Z"
  },
  "meta": {
    "request_id": "7d4c2f48-9a1b-4c3d-8e2f-1a2b3c4d5e6f"
  }
}
```

## Sitemap

See the full [sitemap](https://cascades.crscreditapi.com/sitemap.md) for all pages.