Aggiornare un pannello

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

Cambia la configurazione di un pannello: nome, messaggio embed, colore, aspetto del pulsante e se ignorare la chiusura automatica. Il messaggio del pannello su Discord viene aggiornato in automatico. Richiede il permesso `manage_panels` (disattivato per impostazione predefinita).

Corpo della richiesta (tutti i campi sono facoltativi: invia solo quelli che vuoi cambiare)

Nome	Tipo	Obbligatorio	Descrizione
panel_title	string\|null	facoltativo	Titolo dell'embed (max 256 caratteri). Invia `null` per svuotarlo.
panel_description	string\|null	facoltativo	Descrizione dell'embed (max 4096 caratteri). Invia `null` per svuotarla.
panel_content	string\|null	facoltativo	Testo semplice sopra l'embed (max 2000 caratteri). Invia `null` per svuotarlo.
panel_footer	string\|null	facoltativo	Testo del piè di pagina dell'embed (max 2048 caratteri). Invia `null` per svuotarlo.
panel_color	string\|null	facoltativo	Colore dell'embed come stringa esadecimale, ad esempio `#5865F2`. Invia `null` per svuotarlo.
panel_image_url	string\|null	facoltativo	Immagine dell'embed come URL http(s). Invia `null` per svuotarla.
panel_thumbnail_url	string\|null	facoltativo	Miniatura dell'embed come URL http(s). Invia `null` per svuotarla.
panel_name	string	facoltativo	Nome del pannello usato per i nomi dei ticket (max 100 caratteri). Solo per i pannelli singoli.
button_text	string\|null	facoltativo	Testo del pulsante (max 80 caratteri). Solo per i pannelli singoli.
button_color	string	facoltativo	Stile del pulsante: `primary`, `secondary`, `success` o `danger`. Solo per i pannelli singoli.
button_emoji	string\|null	facoltativo	Emoji del pulsante (unicode o ID di un'emoji personalizzata). Solo per i pannelli singoli.
disabled	boolean	facoltativo	Disattiva o riattiva il pannello. Solo per i pannelli singoli.
bypass_auto_close	boolean	facoltativo	Lascia i ticket di questo pannello fuori dalla chiusura automatica, anche quando è attiva per il server. Solo per i pannelli singoli.
dropdown_placeholder	string\|null	facoltativo	Testo segnaposto del menu a tendina (max 150 caratteri). Solo per i pannelli multipli.

Le impostazioni strutturali (canale del pannello, categoria dei ticket, ruolo da menzionare, moduli, team di staff) non si possono cambiare dall'API: per quelle usa la dashboard. La risposta include message_refreshed; se vale false (oppure hai cambiato dropdown_placeholder su un pannello multiplo), chiama Reinviare un pannello per aggiornare il messaggio su Discord.

I pannelli che usano un layout a componenti rifiutano panel_title, panel_description, panel_content, panel_footer, panel_color, panel_image_url e panel_thumbnail_url con un errore 400. Modifica invece il loro layout nella dashboard.

Esempio di richiesta

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>

Esempio di risposta

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