启用一个 Forward Identity。
POST /api/v1/forward/identities/{identity_id}/enable
请求头
| Header | 是否必填 | 说明 |
|---|---|---|
| Authorization | 是 | Bearer <PAT 或 SAT> |
路径参数
| 参数 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| identity_id | string | 是 | Forward Identity ID。 |
示例响应
HTTP 200 OK
响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
| id | string | Identity ID。 |
| enabled | boolean | 启用后的状态，固定为 true。 |
错误
| HTTP | Type | Code | 触发条件 |
|---|---|---|---|
| 401 | authentication_error | - | PAT 或 SAT 无效、已过期或缺失。 |
| 404 | not_found_error | - | Identity 不存在或当前调用方不可见。 |
| 409 | conflict_error | ADMIN_IDENTITY_READ_ONLY | 目标为管理员 Identity。 |
备注
- 启用后，允许新的执行请求，也可在原有 Session 中继续发起新一轮对话；原有会话忙状态和排队规则仍然适用。
- 周期 Schedule 从未来的触发点继续，不补跑停用期间错过的触发；已经过期的一次性触发会保留
skippedRun 并按正常规则归档。 - 手动暂停、已归档或已删除的 Schedule 不会被恢复，手动关闭的 Channel 也不会被自动开启。