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.
/v1/workflows/update-lambda-versionPlans 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.
bearerAuth In: header
Client-generated key used to make workflow trigger retries safe.
application/json
TypeScript Definitions
Use the request body type in TypeScript.
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"}Trigger add-subdomain POST
Plans and applies Route 53 records for labels relative to rootDomain, pausing for approval before replacing existing records. The request schema trims and lowercases DNS names, removes a final dot, and deduplicates labels; values such as blog and offers.eu are relative labels, not full names under the root. Required permission: workflows:add-subdomain. A new request is accepted for asynchronous Workflow SDK execution; use the returned execution ID with GET /v1/executions/{id} to track it.
Get the persisted add-subdomain DNS plan GET
Reads the persisted DNS plan after checking the workflows:add-subdomain entitlement for the execution. The operation is read-only and succeeds only for an add-subdomain execution with a valid plan already produced; other workflow or planning states return a conflict.
Value in
Default
{ "dryRun": false}Value in
0 < value <= 9007199254740991