Dokumentation

Lær TicketsX hurtigere

Guider, alle kommandoer, Premium-funktioner og REST-API'et ét sted.

13.15

Skift panel for en sag

POST/<guild_id>/api/tickets/<ticket_id>/switch-panel

Flytter en sag til et andet enkelt panel. Det svarer til kommandoen /switchpanel i API'et. Sagen får navn efter det nye panels navneskabelon, bliver flyttet til dets kategori (for sager, der er kanaler), og det nye panels supportteams får adgang. Kræver rettigheden `switch_panel` (slået fra som standard).

Kaldets indhold

NavnTypePåkrævetBeskrivelse
panel_idnumber
påkrævet
Id på det enkle panel, sagen skal flyttes til (se Vis paneler).
keep_permissionsboolean
valgfrit
Beholder kanalens nuværende rollerettigheder ud over det nye panels teams (standard true). Sæt den til false for kun at give det nye panels supportteams adgang.

Sagstyperne skal passe sammen: sager, der er kanaler, kan kun flyttes til kanalbaserede paneler, og sager, der er tråde, kun til trådbaserede paneler. Fordi skiftet omdøber kanalen, tillader Discord det omtrent to gange pr. 10 minutter; dette endepunkt holder den samme grænse og svarer 429 med retry_after, når den bliver overskredet.

Eksempel på kald
curl -X POST \
  -H "Authorization: Bearer <API_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"panel_id":2,"keep_permissions":true}' \
  https://api.ticketsx.xyz/<guild_id>/api/tickets/<ticket_id>/switch-panel
Eksempel på svar
{
  "message": "Panel switched to `Billing` successfully.",
  "ticket_id": 42,
  "panel_id": 2,
  "keep_permissions": true
}