Panel eines Tickets wechseln

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

Verschiebt ein Ticket in ein anderes Einzel-Panel. Das ist das API-Gegenstück zum Befehl /switchpanel. Das Ticket wird nach dem Namensschema des neuen Panels umbenannt, bei Kanal-Tickets in dessen Kategorie verschoben, und die Support-Teams des neuen Panels bekommen Zugriff. Erfordert die Berechtigung `switch_panel` (standardmäßig aus).

Anfragekörper

Name	Typ	Pflichtfeld	Beschreibung
panel_id	number	erforderlich	ID des Einzel-Panels, in das gewechselt wird (siehe "Panels auflisten").
keep_permissions	boolean	optional	Behält zusätzlich zu den Teams des neuen Panels die aktuellen Rollenberechtigungen des Kanals (Standard `true`). Mit `false` wird der Rollenzugriff auf die Support-Teams des neuen Panels zurückgesetzt.

Die Ticketmodi müssen zusammenpassen: Kanal-Tickets wechseln nur zu kanalbasierten Panels, Thread-Tickets nur zu threadbasierten. Da beim Wechsel der Kanal umbenannt wird, erlaubt Discord das nur etwa zweimal pro 10 Minuten. Dieser Endpunkt hält sich daran und liefert bei Überschreitung 429 mit retry_after.

Beispielanfrage

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

Beispielantwort

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