# 删除托管沙箱

```{raw} html
<div class="mo-api-page-show-toc" aria-hidden="true"></div>
```

在请求内推进凭据、远端资源及Ownership清理；成功返回200和空对象。

```text
DELETE https://api.moi.matrixorigin.cn/v5/admin/agent-sandboxes/{id}
```

## 调用前准备

准备当前环境有效身份、已配置的管理员资格和可用鉴权工作区；工作区Owner或Genesis的taas:admin并不自动等于这类管理员。示例使用个人访问令牌与唯一 X-Workspace-ID。见[AI Studio](../../../../../developer/api/ai-studio/index.md)。

删除前确认目标工作区、资源ID和可删除数据。本动作不可恢复原运行内容，仅在获准可丢弃资源上验证。报错可在部分清理或删除意图持久化后发生，需核对原资源及恢复记录，不能凭404或列表消失判定清理完成，也不要创建替代资源覆盖原ID。

## 请求参数

:::::::{div} mo-api-tabs
::::::{tab-set}
:::::{tab-item} 输入示例

```bash
curl -X DELETE "https://api.moi.matrixorigin.cn/v5/admin/agent-sandboxes/sandbox-example" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "X-Workspace-ID: $AUTH_WORKSPACE_ID"
```

:::::
:::::{tab-item} 参数说明

| 参数 | 类型 | 是否必填 | 说明 |
| --- | --- | --- | --- |
| `X-API-Key` | string | 示例是 | 当前环境有效个人访问令牌；需对应已配置管理员主体。Bearer等其他普通认证方式按环境确认。 |
| `X-Workspace-ID` | string | 是 | 唯一非空鉴权工作区头；不是目标筛选或目标配额工作区。 |
| `id` | string | 是 | 路径为沙箱ID。 |

:::::
::::::
:::::::

## 成功响应

:::::::{div} mo-api-tabs mo-api-response-tabs
::::::{tab-set}
:::::{tab-item} 响应示例

```json
{
  "code": "OK",
  "msg": "OK",
  "data": {}
}
```

:::::
:::::{tab-item} 字段说明

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `code` | string | 成功为OK。 |
| `msg` | string | 成功为OK。 |
| `data` | object | 成功数据。 |
| `data` | object | 固定为空对象{}，不是202受理回执。 |

嵌套对象的全部公开字段见[公共对象](objects.md)，省略与null分别说明。
:::::
::::::
:::::::

## 错误响应

:::::::{div} mo-api-tabs
::::::{tab-set}
:::::{tab-item} 响应示例

```json
{"code":"ErrParamInvalid","msg":"Bad Request"}
```

:::::
:::::{tab-item} 字段说明

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `code` | string | 当前阶段错误代码。 |
| `msg` | string | 错误文本，service分类通常本地化。 |

| HTTP / code | 条件与处理 |
| --- | --- |
| 400 / ErrParamInvalid | 缺少鉴权工作区、请求解码/整数解析失败或配额字段无效。 |
| 400 / SANDBOX_INVALID_SPEC | 列表窗口或网络工具等service校验失败，名称虽含SPEC也不只指创建规格。 |
| 403 / COMPUTE_RESOURCE_SPEC_FORBIDDEN | 当前主体不是配置管理员或权限检查边界身份不匹配。 |
| 503 / COMPUTE_RESOURCE_SPEC_ADMIN_UNAVAILABLE | 已分类的管理员目录/授权事实不可用。 |
| 404 / SANDBOX_NOT_FOUND | 非托管/临时/池资源，资源不存在，或处于被隐藏的创建/删除阶段。 |
| 503 / SANDBOX_IAM_UNAVAILABLE 或 SANDBOX_NETWORK_STORAGE_UNAVAILABLE | 生命周期身份或网络持久化依赖不可用。 |
| 500 / SANDBOX_ERROR 或 ErrServer | 未专门分类的Provider等失败，或本地化失败；不能一律写成503。 |

不同恢复阶段见[错误与恢复](errors-recovery.md)。
:::::
::::::
:::::::
