---
title: "Remove Deployment"
method: DELETE
path: "/deployments/{id}"
tags: ["Deployment"]
---

# Remove Deployment

`DELETE /deployments/{id}`

Used to remove a deployment

## Path parameters

- `id` string, required

## Response `200`

The deployment that was removed

- Deployment
  - `id` string — The ID of the deployment
  - `created_time` integer — Time at which the deployment was created
  - `created_by_id` string — The ID of the user who created this deployment
  - `last_updated_time` integer — Time at which the deployment was last updated
  - `last_updated_by_id` string — The ID of the user who last updated this deployment
  - `organization_id` string — The ID of the organization associated with this deployment
  - `application_id` string — The ID of the application associated with this deployment
  - `environment_id` string — The ID of the environment associated with this deployment
  - `name` string — The display name of the deployment
  - `tags` Tag[] — Free text tags associated with this entity
    - `name` string, required — tag name
    - `values` string[]
  - `uri` string — URI of the deployment (empty for mobile_application deployment type)
  - `deployment_type` 'web_application' | 'api' | 'mobile_application' — The type of the deployment.
  - `variables` object — Variables for this deployment. Overrides variables with the same name specified in the environment configuration.
  - `link_agent_label` string — DEPRECATED - use link_agent_labels
  - `link_agent_labels` string[] — Overrides the link_agent_labels in the associated environment
  - `link_bypass_mabl_proxy` boolean — Overrides the link_bypass_mabl_proxy in the associated environment (mabl link only)
  - `use_personal_link_agent` boolean — Route this run's test traffic through the triggering user's own personal mablnet Link tunnels (tunnels whose egress is that user's machine), in addition to the environment's configured link agents. The owner is the user who triggers the run, resolved server-side — there is no id to pass. By default the run stripes across every live personal tunnel the user has (e.g. one per machine); set personal_link_tunnel_label to pin it to one. mablnet-only; requires that user to have at least one live personal Link Agent connected.
  - `personal_link_tunnel_label` string — Restrict use_personal_link_agent to a single personal tunnel by its Link label (the tunnel-safe machine hostname the user's `link-agents start --personal` registers under), instead of striping across all of the user's live personal tunnels. Ignored when use_personal_link_agent is not set.
  - `source_control_tag_target` string — Overrides the source_control_tag_target in the associated environment
  - `mobile_app_file_id` string — Identifier of mobile app file for this deployment (empty for web_application and api deployment types)

## Other responses

- `400` — Invalid or missing parameter
- `401` — User not authenticated
- `403` — User not authorized
- `404` — Deployment not found
- `default` — Unknown error

---

[API](https://skmtc.net/mabl/apis/mabl-api.md) · [All operations](https://skmtc.net/mabl/apis/mabl-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mabl/mabl-api/revisions/d0fc0114da66/schema)