deploy.kill-switches.releaseRelease a kill switch
Request syntax
DELETE /deploy/api/kill-switches/{switchId}Path parameters
switchIdRequiredstring
Constraints: uuid
Response
200 with `data`: the released switch. 409 when it was already released. The app serves as configured again on the machines’ next poll; a scaled-to-zero app starts its containers again.
A JSON response is wrapped as { "success": true, "data": … }; the CLI prints the whole body with --json.
Fields of data
idAlwaysstring
The switch id, which releases itappIdAlwaysstring
The app it is pulled onappNameWhen presentstring
The app’s name (list-active only)kindAlwaysone of route_offline, private_only, scale_to_zero
What the switch doeslabelAlwaysstring
The kind, for people: "Route offline"targetAlwaysstring, may be null
route_offline: the hostname or path prefix; null for the other kindsreasonAlwaysstring
Why it was pulled, as givenfindingIdAlwaysstring, may be null
The Security Posture finding it was pulled fromactiveAlwaysboolean
true until releasedappliedByAlwaysstring
Who pulled itappliedAtAlwaysstring
When it was pulledreleasedByAlwaysstring, may be null
Who released it; null while activereleasedAtAlwaysstring, may be null
When it was released; null while active
Checked against the handlers: every route test validates their answers against this schema.
Errors
- 400The request does not pass the schema above. The body is { "error": …, "issues": […] }, one issue per field.
- 401No credentials, or an access key that is unknown, revoked or expired.
- 403The caller's policies do not allow deploy:ReleaseKillSwitch on this resource. The body names the action and the resource, and the refusal is recorded in the audit log.
- 404The resource does not exist in your organization.
Examples
The required parameters only, with example values. Replace id and the other placeholders with your own.
dcloud deploy kill-switches release switchIdcurl -X DELETE "https://console.platform.deutschecloud.app/deploy/api/kill-switches/switchId" \
-H "Authorization: EWS-ACCESS-KEY $ACCESS_KEY"Generated from the API description, the same one the API checks requests against and the CLI is built from. MCP tool: dcloud_deploy_kill-switches_release.