Panel aktualisieren

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

Ändert die Einrichtung eines Panels: Name, Embed-Nachricht, Farbe, Schaltflächengestaltung und ob das automatische Schließen ignoriert wird. Die aktive Panel-Nachricht in Discord wird automatisch aufgefrischt. Erfordert die Berechtigung `manage_panels` (standardmäßig aus).

Anfragekörper (alle Felder optional, schick nur, was du ändern willst)

Name	Typ	Pflichtfeld	Beschreibung
panel_title	string\|null	optional	Embed-Titel (höchstens 256 Zeichen). Mit `null` leeren.
panel_description	string\|null	optional	Embed-Beschreibung (höchstens 4096 Zeichen). Mit `null` leeren.
panel_content	string\|null	optional	Reiner Text über dem Embed (höchstens 2000 Zeichen). Mit `null` leeren.
panel_footer	string\|null	optional	Text der Embed-Fußzeile (höchstens 2048 Zeichen). Mit `null` leeren.
panel_color	string\|null	optional	Embed-Farbe als Hex-Zeichenkette, zum Beispiel `#5865F2`. Mit `null` leeren.
panel_image_url	string\|null	optional	Embed-Bild als http(s)-URL. Mit `null` leeren.
panel_thumbnail_url	string\|null	optional	Embed-Vorschaubild als http(s)-URL. Mit `null` leeren.
panel_name	string	optional	Panel-Name, der für die Ticketbenennung genutzt wird (höchstens 100 Zeichen). Nur bei Einzel-Panels.
button_text	string\|null	optional	Beschriftung der Schaltfläche (höchstens 80 Zeichen). Nur bei Einzel-Panels.
button_color	string	optional	Stil der Schaltfläche: `primary`, `secondary`, `success` oder `danger`. Nur bei Einzel-Panels.
button_emoji	string\|null	optional	Emoji der Schaltfläche (Unicode oder ID eines eigenen Emojis). Nur bei Einzel-Panels.
disabled	boolean	optional	Deaktiviert das Panel oder schaltet es wieder ein. Nur bei Einzel-Panels.
bypass_auto_close	boolean	optional	Nimmt Tickets dieses Panels vom automatischen Schließen aus, auch wenn es für den Server aktiv ist. Nur bei Einzel-Panels.
dropdown_placeholder	string\|null	optional	Platzhaltertext des Dropdowns (höchstens 150 Zeichen). Nur bei Multi-Panels.

Strukturelle Einstellungen (Panel-Kanal, Ticket-Kategorie, erwähnte Rolle, Formulare, Support-Teams) lassen sich nicht über die API ändern, dafür nutzt du das Dashboard. Die Antwort enthält message_refreshed. Steht dort false (oder hast du bei einem Multi-Panel dropdown_placeholder geändert), ruf "Panel erneut senden" auf, um die Discord-Nachricht zu aktualisieren.

Panels mit Komponenten-Layout lehnen panel_title, panel_description, panel_content, panel_footer, panel_color, panel_image_url und panel_thumbnail_url mit einem 400-Fehler ab. Bearbeite ihr Layout stattdessen im Dashboard.

Beispielanfrage

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>

Beispielantwort

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