API Reference

Get the persisted add-subdomain DNS plan

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.

GET/v1/executions/{id}/subdomain-plan

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.

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Path Parameters

id*string

Execution ID.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/executions/string/subdomain-plan"
{  "plan": {    "apexAlias": {      "dnsName": "string",      "evaluateTargetHealth": true,      "hostedZoneId": "string"    },    "executionId": "string",    "hostedZoneId": "string",    "items": [      {        "current": {          "aliasTarget": {            "dnsName": "string",            "evaluateTargetHealth": true,            "hostedZoneId": "string"          },          "name": "string",          "ttl": 1,          "type": "A",          "values": []        },        "disposition": "already-correct",        "hostname": "string"      }    ],    "planHash": "string",    "replacementRequired": true,    "rootDomain": null  }}

Trigger update-lambda-version POST

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.

Approve an add-subdomain replacement plan POST

Requires the workflows:add-subdomain entitlement for the execution and mutates a paused workflow by resuming its approval hook. The execution must be waiting for replacement approval of the submitted current plan hash; an already accepted approval is replayed safely.