Mettre à jour un panneau

PATCH/<guild_id>/api/panels/<panel_id>

Modifie la configuration d'un panneau : nom, message embed, couleur, style des boutons et prise en compte ou non de la fermeture automatique. Le message du panneau publié sur Discord est actualisé automatiquement. Nécessite la permission `manage_panels` (désactivée par défaut).

Corps de la requête (tous les champs sont facultatifs, n'envoie que ce que tu veux changer)

Nom	Type	Obligatoire	Description
panel_title	string\|null	facultatif	Titre de l'embed (256 caractères max). Envoie `null` pour l'effacer.
panel_description	string\|null	facultatif	Description de l'embed (4096 caractères max). Envoie `null` pour l'effacer.
panel_content	string\|null	facultatif	Texte brut au-dessus de l'embed (2000 caractères max). Envoie `null` pour l'effacer.
panel_footer	string\|null	facultatif	Texte du pied de page de l'embed (2048 caractères max). Envoie `null` pour l'effacer.
panel_color	string\|null	facultatif	Couleur de l'embed en hexadécimal, par exemple `#5865F2`. Envoie `null` pour l'effacer.
panel_image_url	string\|null	facultatif	Image de l'embed sous forme d'URL http(s). Envoie `null` pour l'effacer.
panel_thumbnail_url	string\|null	facultatif	Miniature de l'embed sous forme d'URL http(s). Envoie `null` pour l'effacer.
panel_name	string	facultatif	Nom du panneau utilisé pour nommer les tickets (100 caractères max). Panneaux simples uniquement.
button_text	string\|null	facultatif	Libellé du bouton (80 caractères max). Panneaux simples uniquement.
button_color	string	facultatif	Style du bouton : `primary`, `secondary`, `success` ou `danger`. Panneaux simples uniquement.
button_emoji	string\|null	facultatif	Emoji du bouton (unicode ou identifiant d'emoji personnalisé). Panneaux simples uniquement.
disabled	boolean	facultatif	Désactive ou réactive le panneau. Panneaux simples uniquement.
bypass_auto_close	boolean	facultatif	Exclut les tickets de ce panneau de la fermeture automatique, même si elle est activée pour le serveur. Panneaux simples uniquement.
dropdown_placeholder	string\|null	facultatif	Texte indicatif du menu déroulant (150 caractères max). Panneaux multiples uniquement.

Les réglages structurels (salon du panneau, catégorie de tickets, rôle à mentionner, formulaires, équipes de support) ne se changent pas via l'API ; passe par le tableau de bord. La réponse contient message_refreshed. Si sa valeur est false (ou si tu as changé dropdown_placeholder sur un panneau multiple), appelle "Renvoyer un panneau" pour mettre à jour le message Discord.

Les panneaux qui utilisent une mise en page en composants refusent panel_title, panel_description, panel_content, panel_footer, panel_color, panel_image_url et panel_thumbnail_url avec une erreur 400. Modifie plutôt leur mise en page dans le tableau de bord.

Exemple de requête

curl -X PATCH \
  -H "Authorization: Bearer <API_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"panel_title":"Contact Support","panel_color":"#57F287","button_text":"Get Help","button_color":"success"}' \
  https://api.ticketsx.xyz/<guild_id>/api/panels/<panel_id>

Exemple de réponse

{
  "message": "Panel updated",
  "message_refreshed": true,
  "panel": {
    "PanelId": 1,
    "Type": "single",
    "PanelName": "Support",
    "PanelMessage": {
      "PanelTitle": "Contact Support",
      "PanelColor": "#57F287",
      "ButtonText": "Get Help",
      "ButtonColor": "success"
    }
  }
}