# 更新管理工单状态与回复

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

修改工单状态或管理员回复；不创建奖励审批或外部 Issue。

```text
PATCH https://api.moi.matrixorigin.cn/v5/admin/feedback-tickets/{id}
```

## 调用前准备

准备当前环境可用的 Genesis 管理员 Bearer；普通个人访问令牌、X-API-Key 和工作区 Owner 不能替代。会话模式的写操作另需 CSRF。参见[AI Studio](../../../../../developer/api/ai-studio/index.md)。示例 ID 需换为获准查看的真实工单 ID。

{}、null 或两字段均为 null 不满足更新要求。当前仅校验目标状态，不保证只能按单一顺序流转；processing 与 closed 之间也可能重设。更新响应不执行身份目录投影，user_info 不保证与详情一致。

## 请求参数

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

```bash
curl -X PATCH "https://api.moi.matrixorigin.cn/v5/admin/feedback-tickets/ticket-example" \
  -H "Authorization: Bearer $GENESIS_ADMIN_TOKEN" \
  -H "Content-Type: application/json" \
  --data '{"status":"processing","admin_reply":""}'
```

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

| 参数 | 类型 | 是否必填 | 说明 |
| --- | --- | --- | --- |
| `Authorization` | string | Bearer示例是 | Bearer 加当前环境可信管理员令牌；不要同时设置 API Key。 |
| `id` | string | 是 | 路径工单 ID。 |
| `status` | string | 与admin_reply至少一项 | 只允许 processing 或 closed；不能写 submitted。省略/null 保留原值。 |
| `admin_reply` | string / null | 与status至少一项 | 省略/null 保留原值；显式空字符串可清空为字符串。 |

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

## 成功响应

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

```json
{
  "code": 0,
  "data": {
    "id": "ticket-example",
    "ticket_no": "FB-EXAMPLE",
    "account_id": "principal-example",
    "uc_account_id": "uc-example",
    "title": "示例反馈",
    "description": "界面显示结果与预期不同。",
    "expected_behavior": null,
    "actual_behavior": null,
    "reproduction_steps": null,
    "suggested_priority": null,
    "status": "processing",
    "admin_reply": "",
    "created_at": "2026-11-12T04:00:00Z",
    "updated_at": "2026-11-12T04:00:00Z",
    "messages": [
      {
        "sequence": 0,
        "role": "user",
        "content": "示例反馈内容。",
        "created_at": "2026-11-12T04:00:00Z"
      }
    ]
  }
}
```

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

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `code` | integer | 成功为数字 0。 |
| `data` | object | 更新后工单。 |
| `data.id` | string | 对象 ID。 |
| `data.ticket_no` | string / null | 反馈编号，可为 null。 |
| `data.account_id` | string | 提交工单的产品主体 ID。 |
| `data.uc_account_id` | string / null | 创建时保存的 UC 账号事实，可为 null；不是本次管理员的账号。 |
| `data.user_info` | object / null，可省略 | 管理员读取时从当前身份目录投影的提交者信息；可省略，未持久化在工单中。 |
| `data.title` | string / null | 标题；工单可为 null。 |
| `data.description` | string / null | 问题描述，可为 null。 |
| `data.expected_behavior` | string / null | 期望行为，可为 null。 |
| `data.actual_behavior` | string / null | 实际行为，可为 null。 |
| `data.reproduction_steps` | string / null | 复现步骤，可为 null。 |
| `data.suggested_priority` | string / null | 用户建议优先级，可为 null，不承诺已分诊。 |
| `data.status` | string | 工单状态 submitted、processing 或 closed。 |
| `data.admin_reply` | string / null | 管理员回复，可为 null；空字符串与 null 不同。 |
| `data.created_at` | string | 创建时间，RFC 3339。 |
| `data.updated_at` | string | 更新时间，RFC 3339。 |
| `data.messages` | object（对象数组），可省略 | 可选对话记录；列表未加载，详情空集合因 omitempty 可省略。 |
| `data.github_issue` | object / null，可省略 | 可选主 GitHub Issue 请求；列表、详情与更新均可带该关联。 |
| `data.reward_event` | object / null，可省略 | 可选奖励审批事实；列表当前未加载，详情与更新按存在与否返回。 |

嵌套工单、用户、消息、审批事实和 GitHub 请求的全部公开字段见[公共对象](objects.md)。字段可空与可省略分别列明，不把旧 SDK fixture 的 submitter_email 当作当前字段。
:::::
::::::
:::::::

## 错误响应

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

```json
{"code":"Unauthorized","msg":"Unauthorized"}
```

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

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `code` | string / integer | 随失败阶段而异；示例为认证层字符串。 |
| `msg` | string | 认证或服务层失败文本，服务层通常本地化。 |
| `message` | string | 参数解析阶段数字错误码的文本；与 msg 区分。 |
| `data` | null | 当前服务层 responseEnvelope 错误保留 null；认证示例可不含此字段。 |
| `details` | object | 文本字段 422 错误可带 field/reason 等，见错误说明。 |

| HTTP / code | 条件与处理 |
| --- | --- |
| 401 / Unauthorized | 认证层拒绝；不要使用普通 PAT 或同时带 X-API-Key。 |
| 403 / ErrForbidden | 未取得可信管理员事实，或当前调用身份与管理员事实不匹配。 |
| 404 / ErrFeedbackTicketNotFound | 目标工单不存在；当前 service 错误返回 code/msg/data:null。 |
| 503 / ErrServiceUnavailable | 已分类的身份、目录、授权依赖不可用或网络超时。 |
| 500 / ErrServer | 内部处理或本地化失败；写请求错误后先回读确认。 |
| 400 / code:2 | 请求解码失败，使用数字 code 与 message。 |
| 400 / ErrParamInvalid 或 ErrFeedbackTicketStatusInvalid | 缺少实际更新字段或目标状态不合法。 |

完整错误族与各阶段见[错误和恢复](errors-recovery.md)。
:::::
::::::
:::::::
