Een paneel bijwerken

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

Wijzigt de opzet van een paneel: naam, embedbericht, kleur, uiterlijk van de knop en of automatisch sluiten wordt overgeslagen. Het paneelbericht in Discord wordt vanzelf ververst. Vereist het recht `manage_panels` (standaard uit).

Body van het verzoek (alle velden optioneel; stuur alleen wat je wilt wijzigen)

Naam	Type	Verplicht	Beschrijving
panel_title	string\|null	optioneel	Titel van de embed (max. 256 tekens). Stuur `null` om hem leeg te maken.
panel_description	string\|null	optioneel	Omschrijving van de embed (max. 4096 tekens). Stuur `null` om hem leeg te maken.
panel_content	string\|null	optioneel	Gewone tekst boven de embed (max. 2000 tekens). Stuur `null` om hem leeg te maken.
panel_footer	string\|null	optioneel	Voettekst van de embed (max. 2048 tekens). Stuur `null` om hem leeg te maken.
panel_color	string\|null	optioneel	Kleur van de embed als hexwaarde, bijvoorbeeld `#5865F2`. Stuur `null` om hem leeg te maken.
panel_image_url	string\|null	optioneel	Afbeelding van de embed als http(s)-URL. Stuur `null` om hem leeg te maken.
panel_thumbnail_url	string\|null	optioneel	Miniatuur van de embed als http(s)-URL. Stuur `null` om hem leeg te maken.
panel_name	string	optioneel	Paneelnaam die gebruikt wordt bij het benoemen van tickets (max. 100 tekens). Alleen bij enkele panelen.
button_text	string\|null	optioneel	Knoptekst (max. 80 tekens). Alleen bij enkele panelen.
button_color	string	optioneel	Knopstijl: `primary`, `secondary`, `success` of `danger`. Alleen bij enkele panelen.
button_emoji	string\|null	optioneel	Knopemoji (unicode of de ID van een eigen emoji). Alleen bij enkele panelen.
disabled	boolean	optioneel	Zet het paneel uit of weer aan. Alleen bij enkele panelen.
bypass_auto_close	boolean	optioneel	Houdt tickets uit dit paneel buiten het automatisch sluiten, ook als dat voor de server aanstaat. Alleen bij enkele panelen.
dropdown_placeholder	string\|null	optioneel	Tijdelijke tekst van het uitklapmenu (max. 150 tekens). Alleen bij meervoudige panelen.

De structurele instellingen (paneelkanaal, ticketcategorie, rol om te pingen, formulieren, teams) zijn niet via de API te wijzigen; gebruik daarvoor het dashboard. Het antwoord bevat message_refreshed; staat daar false (of heb je dropdown_placeholder van een meervoudig paneel gewijzigd), roep dan Een paneel opnieuw plaatsen aan om het Discord-bericht bij te werken.

Panelen met een indeling uit componenten weigeren panel_title, panel_description, panel_content, panel_footer, panel_color, panel_image_url en panel_thumbnail_url met een 400-fout. Pas hun indeling in plaats daarvan aan in het dashboard.

Voorbeeldverzoek

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>

Voorbeeldantwoord

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