切换工单所属面板

POST/<guild_id>/api/tickets/<ticket_id>/switch-panel

把工单转到另一个单一面板。这是 /switchpanel 命令的 API 版本。工单会按新面板的命名规则重命名，频道形式的工单还会移动到新面板的分类下，新面板的客服团队会获得访问权限。需要 `switch_panel` 权限（默认关闭）。

请求体

名称	类型	必填	说明
panel_id	number	必填	工单要切换到的单一面板 ID（参见“列出面板”）。
keep_permissions	boolean	可选	在新面板团队之外，同时保留频道当前的身份组权限（默认 `true`）。设为 `false` 会把身份组访问权限重置为只保留新面板的客服团队。

工单形式必须一致：频道形式的工单只能切换到频道形式的面板，子区形式的工单只能切换到子区形式的面板。由于切换会重命名频道，Discord 把这一操作限制在每 10 分钟约两次；本接口与之保持一致，超出时会返回 429 并带上 retry_after。

请求示例

curl -X POST \
  -H "Authorization: Bearer <API_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"panel_id":2,"keep_permissions":true}' \
  https://api.ticketsx.xyz/<guild_id>/api/tickets/<ticket_id>/switch-panel

响应示例

{
  "message": "Panel switched to `Billing` successfully.",
  "ticket_id": 42,
  "panel_id": 2,
  "keep_permissions": true
}