Atualizar um painel

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

Altera a configuração de um painel: nome, mensagem embed, cor, estilo dos botões e se ele ignora o fechamento automático. A mensagem do painel publicada no Discord é atualizada automaticamente. Exige a permissão `manage_panels` (desativada por padrão).

Corpo da requisição (todos os campos são opcionais, envie só o que quiser mudar)

Nome	Tipo	Obrigatório	Descrição
panel_title	string\|null	opcional	Título do embed (máx. 256 caracteres). Envie `null` para limpar.
panel_description	string\|null	opcional	Descrição do embed (máx. 4096 caracteres). Envie `null` para limpar.
panel_content	string\|null	opcional	Texto simples acima do embed (máx. 2000 caracteres). Envie `null` para limpar.
panel_footer	string\|null	opcional	Texto do rodapé do embed (máx. 2048 caracteres). Envie `null` para limpar.
panel_color	string\|null	opcional	Cor do embed em hexadecimal, por exemplo `#5865F2`. Envie `null` para limpar.
panel_image_url	string\|null	opcional	Imagem do embed como URL http(s). Envie `null` para limpar.
panel_thumbnail_url	string\|null	opcional	Miniatura do embed como URL http(s). Envie `null` para limpar.
panel_name	string	opcional	Nome do painel usado para nomear os tickets (máx. 100 caracteres). Só em painéis simples.
button_text	string\|null	opcional	Rótulo do botão (máx. 80 caracteres). Só em painéis simples.
button_color	string	opcional	Estilo do botão: `primary`, `secondary`, `success` ou `danger`. Só em painéis simples.
button_emoji	string\|null	opcional	Emoji do botão (unicode ou ID de emoji personalizado). Só em painéis simples.
disabled	boolean	opcional	Desativa ou reativa o painel. Só em painéis simples.
bypass_auto_close	boolean	opcional	Deixa os tickets deste painel fora do fechamento automático, mesmo com ele ligado para o servidor. Só em painéis simples.
dropdown_placeholder	string\|null	opcional	Texto de apoio do menu suspenso (máx. 150 caracteres). Só em painéis múltiplos.

Configurações estruturais (canal do painel, categoria de tickets, cargo a mencionar, formulários, equipes de suporte) não podem ser alteradas pela API; use o painel para isso. A resposta traz message_refreshed. Se vier false (ou se você mudou dropdown_placeholder num painel múltiplo), chame "Reenviar um painel" para atualizar a mensagem no Discord.

Painéis que usam um layout de componentes rejeitam panel_title, panel_description, panel_content, panel_footer, panel_color, panel_image_url e panel_thumbnail_url com erro 400. Edite o layout desses painéis no painel de controle.

Exemplo de requisição

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>

Exemplo de resposta

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