13.15
Cambiare il pannello di un ticket
/<guild_id>/api/tickets/<ticket_id>/switch-panelSposta un ticket su un altro pannello singolo. È l'equivalente via API del comando /switchpanel. Il ticket viene rinominato secondo lo schema del nuovo pannello, spostato nella sua categoria (per i ticket su canale) e i team di staff del nuovo pannello ricevono l'accesso. Richiede il permesso `switch_panel` (disattivato per impostazione predefinita).
Corpo della richiesta
| Nome | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| panel_id | number | obbligatorio | ID del pannello singolo su cui spostare il ticket (vedi Elencare i pannelli). |
| keep_permissions | boolean | facoltativo | Mantiene sul canale i permessi dei ruoli attuali oltre ai team del nuovo pannello (predefinito true). Imposta false per lasciare l'accesso ai soli team di staff del nuovo pannello. |
Le modalità dei ticket devono coincidere: i ticket su canale si possono spostare solo su pannelli basati su canali e i ticket in thread solo su pannelli basati su thread. Dato che il cambio rinomina il canale, Discord lo limita a circa due volte ogni 10 minuti; questo endpoint applica lo stesso limite e risponde 429 con retry_after quando viene superato.
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
}