# 解绑配额策略

`POST` `/api/tokenBudget/unbindPolicy`

解除指定身份主体某个配额账户的Token配额管控。不传请求体或不传 scopeAgentId 时解绑全局账户，解绑后该主体恢复不限额使用（若仍有智能体组账户，则在对应智能体上仍受限）；传入共享配额的一组智能体中任意一个智能体的ID时，解绑这组智能体共享的整个账户，组内全部智能体同时解除管控，全局账户与其他组账户不受影响。注意：解绑会同时作废该账户名下全部加油包，剩余额度不退还；重新绑定后额度从零开始计量，不继承解绑前的已用量。仅能解绑策略已分配给当前应用的账户，否则返回 403 错误。本接口仅支持通过API调用。

## 请求参数

### 请求头参数

| 参数名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| X-Principal-Id | integer | 否 | 身份主体ID（Long类型）。通过API访问时必须传递以标识操作主体；通过页面访问时无需传递。可通过「身份主体」模块的创建接口获取。 |

### 请求体（JSON）

| 参数名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| scopeAgentId | integer | 否 | 共享配额的一组智能体中任意一个智能体的ID，选填。不传或 0 表示解绑主体的全局账户；传入时按该智能体所属智能体组定位到对应账户并整体解绑，组内全部智能体同时解除管控，全局账户与其他组账户不受影响 |

## 响应

### 200

| 参数名 | 类型 | 说明 |
|--------|------|------|
| httpStatusCode | integer | HTTP状态码 |
| message | string | 响应消息 |
| data | object | 响应数据 |
| success | boolean | 是否成功 |
| requestId | string | 上游请求ID，用于跨系统链路追踪排查问题 |
| errCode | string | 上游错误码，前端可据此做特殊UI处理 |

### 400

| 参数名 | 类型 | 说明 |
|--------|------|------|
| httpStatusCode | integer | HTTP状态码 |
| message | string | 响应消息 |
| data | object | 响应数据 |
| success | boolean | 是否成功 |
| requestId | string | 上游请求ID，用于跨系统链路追踪排查问题 |
| errCode | string | 上游错误码，前端可据此做特殊UI处理 |

### 500

| 参数名 | 类型 | 说明 |
|--------|------|------|
| httpStatusCode | integer | HTTP状态码 |
| message | string | 响应消息 |
| data | object | 响应数据 |
| success | boolean | 是否成功 |
| requestId | string | 上游请求ID，用于跨系统链路追踪排查问题 |
| errCode | string | 上游错误码，前端可据此做特殊UI处理 |