Documentation

Prends TicketsX en main plus vite

Guides d'installation, référence complète des commandes, fonctionnalités Premium et API REST au même endroit.

13.15

Changer le panneau d'un ticket

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

Déplace un ticket vers un autre panneau simple. C'est l'équivalent API de la commande /switchpanel. Le ticket est renommé selon le schéma du nouveau panneau, déplacé dans sa catégorie (tickets en salon), et les équipes de support du nouveau panneau obtiennent l'accès. Nécessite la permission `switch_panel` (désactivée par défaut).

Corps de la requête

NomTypeObligatoireDescription
panel_idnumber
requis
Identifiant du panneau simple vers lequel basculer le ticket (voir Lister les panneaux).
keep_permissionsboolean
facultatif
Conserve les permissions de rôle actuelles du salon en plus des équipes du nouveau panneau (true par défaut). Mets false pour réinitialiser l'accès aux seules équipes de support du nouveau panneau.

Les modes de ticket doivent correspondre : les tickets en salon ne peuvent basculer que vers des panneaux en salon, et les tickets en fil vers des panneaux en fil. Comme le changement renomme le salon, Discord le limite à environ deux fois par tranche de 10 minutes ; ce point d'accès s'aligne dessus et renvoie 429 avec retry_after en cas de dépassement.

Exemple de requête
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
Exemple de réponse
{
  "message": "Panel switched to `Billing` successfully.",
  "ticket_id": 42,
  "panel_id": 2,
  "keep_permissions": true
}