API Reference

Trigger update-lambda-version

Plans and updates the selected Lambda@Edge fleet to a positive integer version in the requested environment. The strict request schema applies the dry-run default and rejects unsupported target/environment pairs. Required permission: workflows:update-lambda-version. A new request is accepted for asynchronous Workflow SDK execution; use the returned execution ID with GET /v1/executions/{id} to track it. Fleet and provider work continues durably after this request is accepted; stable asynchronous failures are reported on the execution and its events. Request cancellation at /v1/executions/{id}/cancel, retry unfinished work at /v1/executions/{id}/resume, and restore receipt-backed changes at /v1/executions/{id}/rollback.

POST/v1/workflows/update-lambda-version

Plans and updates the selected Lambda@Edge fleet to a positive integer version in the requested environment. The strict request schema applies the dry-run default and rejects unsupported target/environment pairs. Required permission: workflows:update-lambda-version. A new request is accepted for asynchronous Workflow SDK execution; use the returned execution ID with GET /v1/executions/{id} to track it. Fleet and provider work continues durably after this request is accepted; stable asynchronous failures are reported on the execution and its events. Request cancellation at /v1/executions/{id}/cancel, retry unfinished work at /v1/executions/{id}/resume, and restore receipt-backed changes at /v1/executions/{id}/rollback.

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Header Parameters

Idempotency-Key*string

Client-generated key used to make workflow trigger retries safe.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/workflows/update-lambda-version" \  -H "Idempotency-Key: string" \  -H "Content-Type: application/json" \  -d '{    "environment": "test",    "options": {      "dryRun": false    },    "target": "microbrands",    "version": 43  }'
{  "estimatedDurationSeconds": 0,  "executionId": "string",  "links": {    "cancel": "string",    "events": "string",    "self": "string"  },  "stages": [    "string"  ],  "status": "canceled",  "workflow": "string",  "workflowRunId": "string"}