チケットのパネルを変更

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

チケットを別の単一パネルに移します。/switchpanel コマンドの API 版です。チケットは新しいパネルの命名規則で名前が変わり、チャンネル形式の場合はそのカテゴリに移動し、新しいパネルのサポートチームにアクセス権が与えられます。`switch_panel` の権限が必要です(初期状態ではオフ)。

リクエストボディ

名前	型	必須	説明
panel_id	number	必須	チケットの移動先となる単一パネルの ID(「パネルの一覧取得」を参照)。
keep_permissions	boolean	任意	新しいパネルのチームに加えて、チャンネルの現在のロール権限も残します(既定値は `true`)。`false` にすると、ロールのアクセス権は新しいパネルのサポートチームだけにリセットされます。

チケットの形式は一致している必要があります。チャンネル形式のチケットはチャンネル形式のパネルへ、スレッド形式のチケットはスレッド形式のパネルへのみ移せます。移動の際にチャンネル名が変わるため、Discord の制限により 10 分あたり 2 回程度までです。このエンドポイントも同じ制限に合わせており、超過すると 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
}