Switch a Ticket’s Panel

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

Move a ticket to a different single panel — the API equivalent of the /switchpanel command. The ticket is renamed to the new panel’s naming scheme, moved to its category (channel tickets), and the new panel’s support teams are granted access. Requires the `switch_panel` permission (off by default).

Request Body

Name	Type	Required	Description
panel_id	number	required	ID of the single panel to switch the ticket to (see List Panels).
keep_permissions	boolean	optional	Keep the current role permissions on the channel in addition to the new panel’s teams (default `true`). Set `false` to reset role access to the new panel’s support teams only.

Ticket modes must match: channel tickets can only switch to channel-based panels and thread tickets to thread-based panels. Because the switch renames the channel, Discord limits it to roughly twice per 10 minutes; this endpoint is rate limited to match and returns 429 with retry_after when exceeded.

Example request

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

Example response

{
  "message": "Panel switched to `Billing` successfully.",
  "ticket_id": 42,
  "panel_id": 2,
  "keep_permissions": true
}

Sections

Switch a Ticket’s Panel

Request Body