---
title: "Delete a workspace"
method: DELETE
path: "/runners/workspaces/{workspaceId}"
tags: ["Runners Workspaces"]
---

# Delete a workspace

`DELETE /runners/workspaces/{workspaceId}`

Deletes a specific workspace and optionally destroys its infrastructure resources

## Path parameters

- `workspaceId` string, required

## Query parameters

- `destroy` boolean
- `description` string

## Response `200`

Workspace deleted successfully

- object
  - `message` string
  - `workspaceId` string — The ID of the deleted workspace
  - `resourcesDestroyed` boolean — Whether resources were destroyed

## Other responses

- `400` — Bad Request Error
- `401` — Unauthorized Error
- `403` — Insufficient permissions
- `404` — Not Found Error
- `500` — Internal Server Error

---

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