> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vertracloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete Workspace

> Soft-deletes a workspace. Owner only; an API key needs the `workspaces:delete` scope.

<Note>
  An API key needs the `workspaces:delete` scope. It has no `read`/`write` suffix, so the
  `read` and `write` presets never include it — only `full` or a custom selection does. The
  owner check still applies: a key acts as the account that owns it.
</Note>

The deletion is logical: members, roles, invites and app/database links are removed, and the
name becomes free to reuse for a new workspace.

### Path

<ParamField path="id" type="string" required>
  Workspace ID.
</ParamField>

### Response

Empty response on success.

### Errors

| Status | Code                   | When                                                             |
| ------ | ---------------------- | ---------------------------------------------------------------- |
| 403    | `API_KEY_SCOPE_DENIED` | Called with an API key that lacks the `workspaces:delete` scope. |
| 403    | `WORKSPACE_OWNER_ONLY` | Caller isn't the owner.                                          |
| 404    | `WORKSPACE_NOT_FOUND`  | Workspace doesn't exist or is already deleted.                   |