---
title: "Delete deployment"
method: DELETE
path: "/deployments/{deployment}"
tags: ["deployment"]
---

# Delete deployment

`DELETE /deployments/{deployment}`

Delete a deployment. Currently, only forced deletions are supported.
**Use with caution**: forcing a deployment deletion can break in-flight invocations.

## Path parameters

- `deployment` string, required

## Query parameters

- `force` boolean, nullable

## Response `202`

Deployment deletion accepted and will be processed asynchronously

## Other responses

- `400` — Bad request
- `404` — Not found
- `405` — Method not allowed
- `409` — Conflict
- `500` — Internal server error
- `501` — Not implemented. Graceful deployment deletion (force=false) is not yet supported.

## Changes

- **2026-01-30** `059a44500a5c` — 4 info
  - added the media type `application/json` for the response with the status `501`
  - added the non-success response with the status `405`
  - removed the non-success response with the status `403`
  - removed the non-success response with the status `503`

[Change history](https://skmtc.dev/restatedev/apis/admin-api/changes/deployments/:deployment/delete.md)

---

[API](https://skmtc.dev/restatedev/apis/admin-api.md) · [All operations](https://skmtc.dev/restatedev/apis/admin-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/restatedev/admin-api/revisions/5361f4818c71/schema)