---
title: "DELETE /greengrass/v2/deployments/{deploymentId}"
method: DELETE
path: "/greengrass/v2/deployments/{deploymentId}"
---

# DELETE /greengrass/v2/deployments/{deploymentId}

`DELETE /greengrass/v2/deployments/{deploymentId}`

Deletes a deployment. To delete an active deployment, you must first cancel it. For more information, see [CancelDeployment](https://docs.aws.amazon.com/iot/latest/apireference/API_CancelDeployment.html).

Deleting a deployment doesn't affect core devices that run that deployment, because core devices store the deployment's configuration on the device. Additionally, core devices can roll back to a previous deployment that has been deleted.

## Path parameters

- `deploymentId` string, required

## Response `204`

Success

## Other responses

- `480` — ResourceNotFoundException
- `481` — ValidationException
- `482` — AccessDeniedException
- `483` — InternalServerException
- `484` — ConflictException
- `485` — ThrottlingException

---

[API](https://skmtc.net/aws/apis/greengrassv2.md) · [All operations](https://skmtc.net/aws/apis/greengrassv2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/greengrassv2/versions/f491b1d234d1/schema)