--- title: Re-evaluate an execution — POST /api/v1/executions/{id}/re_evaluations description: Creates a new execution that re-runs the source's input_context against the source's snapshotted definition (NOT the workflow's current definition) and… canonical_url: "https://cascades.crscreditapi.com/docs/api/executions/re-evaluate-execution" doc_version: "1.0.0" last_updated: "2026-10-09T18:04:24Z" source: "public/api-docs/v1/swagger.yaml#reEvaluateExecution" --- # Re-evaluate an execution — POST /api/v1/executions/{id}/re_evaluations `POST https://cascades.crscreditapi.com/api/v1/executions/{id}/re_evaluations` - Operation id: `reEvaluateExecution` - Scopes: `executions:write` - Idempotent: yes (`Idempotency-Key` header required) - Asynchronous: returns `202 Accepted`; poll `GET /executions/{id}` - OpenAPI: https://cascades.crscreditapi.com/openapi.json · https://cascades.crscreditapi.com/openapi.yaml (operationId `reEvaluateExecution`) Creates a new execution that re-runs the source's `input_context` against the source's snapshotted definition (NOT the workflow's current definition) and returns `202`; poll `getExecution` on the new id. The source must belong to an active workflow, and re-running a live-mode execution requires production access. `Idempotency-Key` is required and is namespaced per source execution, so the same key can be reused across different sources. Requires `executions:write`. ## Path parameters | Name | Type | Required | Description | |---|---|---|---| | `id` | integer | yes | Execution id. Scoped to the calling api_client; a foreign id returns 404. | ## Header parameters | Name | Type | Required | Description | |---|---|---|---| | `Idempotency-Key` | string | yes | Unique per-business-event key. Identical resubmissions return the original response; conflicting bodies return 409 idempotency_conflict. Concurrent identical requests are race-safe. A missing or blank header returns 422 missing_idempotency_key. The header is accepted up to 200 characters, but the stored key is namespaced to your client (api_client::, and for re-evaluations api_client::reeval::) and the stored value is capped at 200 characters — so the effective limit on trigger is about 185 characters and lower still on re_evaluations. Use a UUID (36 characters) or another key of at most 128 characters to stay clear of the cap. | ## Responses ### 202 — Re-evaluation accepted (the NEW execution) `application/json` | Field | Type | Required | Description | |---|---|---|---| | `data` | Execution | no | | |   `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_key` | string, nullable | no | | |   `external_reference` | string, nullable | no | | |   `needs_human_review` | boolean | yes | | |   `review_status` | string | yes | One of: `"none"`, `"in_review"`, `"approved"`, `"denied"`. | |   `assigned_to_user_id` | integer, nullable | no | The reviewer who claimed this execution, if any. | |   `started_at` | string (date-time), nullable | no | | |   `completed_at` | string (date-time), nullable | no | | |   `created_at` | string (date-time) | yes | | |   `updated_at` | string (date-time), nullable | no | | |   `input_context` | object | no | The payload originally sent at trigger time, plus resolved fields such as `execution_mode`, `submitted_by_user_id`, `user_approved`, `external_reference`, (for a test-mode run of a draft) `allow_inactive` and (for a test-mode run that replays a registered test subject) `sandbox_replay`. | | `meta` | Meta | no | | |   `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_key": "api_client:12:3fa85f64-5717-4562-b3fc-2c963f66afa6", "external_reference": "rv-app-20491", "needs_human_review": true, "review_status": "none", "assigned_to_user_id": 1, "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", "input_context": {} }, "meta": { "request_id": "7d4c2f48-9a1b-4c3d-8e2f-1a2b3c4d5e6f" } } ``` ### 401 — Missing, malformed, expired or revoked bearer token. The `WWW-Authenticate` header carries the RFC 6750 challenge. `application/json` — `ErrorEnvelope` ```json { "error": { "code": "unauthorized", "message": "A valid bearer token is required.", "details": [], "request_id": "7d4c2f48-9a1b-4c3d-8e2f-1a2b3c4d5e6f", "doc_url": "https://cascades.crscreditapi.com/docs/api/errors/unauthorized" } } ``` ### 403 — `insufficient_scope` or `live_mode_forbidden` `application/json` — `ErrorEnvelope` ```json { "error": { "code": "live_mode_forbidden", "message": "Re-running a live-mode execution requires production access.", "details": [], "request_id": "7d4c2f48-9a1b-4c3d-8e2f-1a2b3c4d5e6f", "doc_url": "https://cascades.crscreditapi.com/docs/api/errors/live_mode_forbidden" } } ``` ### 404 — Resource does not exist or belongs to another tenant / api_client `application/json` — `ErrorEnvelope` ```json { "error": { "code": "not_found", "message": "The requested resource was not found.", "details": [], "request_id": "7d4c2f48-9a1b-4c3d-8e2f-1a2b3c4d5e6f", "doc_url": "https://cascades.crscreditapi.com/docs/api/errors/not_found" } } ``` ### 409 — `workflow_inactive` `application/json` — `ErrorEnvelope` ```json { "error": { "code": "workflow_inactive", "message": "Only active workflows can be re-evaluated through the public API.", "details": [], "request_id": "7d4c2f48-9a1b-4c3d-8e2f-1a2b3c4d5e6f", "doc_url": "https://cascades.crscreditapi.com/docs/api/errors/workflow_inactive" } } ``` ### 422 — `missing_idempotency_key` `application/json` — `ErrorEnvelope` ```json { "error": { "code": "missing_idempotency_key", "message": "Idempotency-Key header is required.", "details": [], "request_id": "7d4c2f48-9a1b-4c3d-8e2f-1a2b3c4d5e6f", "doc_url": "https://cascades.crscreditapi.com/docs/api/errors/missing_idempotency_key" } } ``` ### 429 — Rate limit exceeded (60 req/min per IP on `/api/v1`, 600 req/hour per token prefix, or 300 req/5 min per IP globally). The body is the standard error envelope and `Retry-After` gives the seconds until the window resets. `application/json` — `ErrorEnvelope` ```json { "error": { "code": "rate_limited", "message": "Rate limit exceeded. Retry later.", "details": [], "request_id": "7d4c2f48-9a1b-4c3d-8e2f-1a2b3c4d5e6f", "doc_url": "https://cascades.crscreditapi.com/docs/api/errors/rate_limited" } } ``` ## Code samples ### cURL ```shell curl -X POST "https://cascades.crscreditapi.com/api/v1/executions/1842/re_evaluations" \ -H "Authorization: Bearer {{API_KEY}}" \ -H "Idempotency-Key: 3fa85f64-5717-4562-b3fc-2c963f66afa6" ``` ### Node.js ```javascript const response = await fetch("https://cascades.crscreditapi.com/api/v1/executions/1842/re_evaluations", { method: "POST", headers: { "Authorization": "Bearer {{API_KEY}}", "Idempotency-Key": "3fa85f64-5717-4562-b3fc-2c963f66afa6" } }); const { data, meta } = await response.json(); console.log(response.status, data, meta.request_id); ``` ### Python ```python import requests response = requests.post( "https://cascades.crscreditapi.com/api/v1/executions/1842/re_evaluations", headers={ "Authorization": "Bearer {{API_KEY}}", "Idempotency-Key": "3fa85f64-5717-4562-b3fc-2c963f66afa6", }, ) response.raise_for_status() payload = response.json() print(payload["data"], payload["meta"]["request_id"]) ``` ### Ruby ```ruby require "net/http" require "json" uri = URI("https://cascades.crscreditapi.com/api/v1/executions/1842/re_evaluations") request = Net::HTTP::Post.new(uri) request["Authorization"] = "Bearer {{API_KEY}}" request["Idempotency-Key"] = "3fa85f64-5717-4562-b3fc-2c963f66afa6" response = Net::HTTP.start(uri.host, uri.port, use_ssl: uri.scheme == "https") do |http| http.request(request) end payload = JSON.parse(response.body) puts payload["data"], payload.dig("meta", "request_id") ``` ### Go ```go package main import ( "fmt" "io" "net/http" ) func main() { req, err := http.NewRequest("POST", "https://cascades.crscreditapi.com/api/v1/executions/1842/re_evaluations", nil) if err != nil { panic(err) } req.Header.Set("Authorization", "Bearer {{API_KEY}}") req.Header.Set("Idempotency-Key", "3fa85f64-5717-4562-b3fc-2c963f66afa6") resp, err := http.DefaultClient.Do(req) if err != nil { panic(err) } defer resp.Body.Close() out, _ := io.ReadAll(resp.Body) fmt.Println(resp.StatusCode, string(out)) } ``` ### Agent ```shell claude mcp add cascades \ -e CASCADES_API_KEY={{API_KEY}} \ -e CASCADES_PROD_BASE_URL=https://cascades.crscreditapi.com \ -- npx -y @crscreditapi/cascades-mcp-server # Then ask your assistant: # "Re-evaluate an execution 1842 using the Cascades API." # No MCP tool covers this endpoint yet; the assistant can call POST /executions/{id}/re_evaluations with curl. ``` ## Related - [Executions](https://cascades.crscreditapi.com/docs/concepts/executions) - [Idempotency](https://cascades.crscreditapi.com/docs/concepts/idempotency) ## Sitemap See the full [sitemap](https://cascades.crscreditapi.com/sitemap.md) for all pages.