---
title: "Delete Workspace"
method: POST
path: "/v2/workspace:delete"
tags: ["Workspaces"]
---

# Delete Workspace

`POST /v2/workspace:delete`

Delete a workspace and all of its resources. This is a destructive operation that takes some time to complete.

Actual deletion of infrastructure resources associated with the workspace only occurs after a retention period.
Once the retention period has expired, the workspace state transitions from `DELETING` to `DELETED`.

## Query parameters

- `name` string, required — Name of the workspace in which to perform the operation.

## Response `200`

Successful Response

- WorkspaceResponse
  - `errors` string[] — List of error messages associated with the resource.
  - `internal_error_details` string[] — List of internal error messages associated with the `errors` field.
  - `id` string, int64, required — The unique identifier of the resource
  - `created_at` string, date-time, required — The time at which the resource was created
  - `created_by` string, required — The ID of the user who created the resource
  - `updated_at` string, date-time, required — The time at which the resource was last updated
  - `updated_by` string, required — The ID of the user who last updated the resource
  - `name` string, required
  - `display_name` string, required
  - `state` 'PROVISIONING' | 'DELETING' | 'READY' | 'FAILED', required
  - `picture_file_id` string, int64, nullable, required
  - `capabilities` WorkspaceCapabilities, required
    - `can_generate_variants` boolean

## Other responses

- `422` — Validation Error

---

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