문서

TicketsX를 더 빠르게 익히세요

설정 안내, 전체 명령어 목록, Premium 기능, REST API를 한곳에 모았습니다.

13.15

티켓의 패널 바꾸기

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

티켓을 다른 단일 패널로 옮깁니다. /switchpanel 명령어에 해당하는 API입니다. 티켓 이름이 새 패널의 이름 규칙에 맞게 바뀌고, 채널 티켓이라면 새 패널의 카테고리로 옮겨지며, 새 패널의 지원팀에 접근 권한이 생깁니다. `switch_panel` 권한이 필요합니다(기본값은 꺼짐).

요청 본문

이름형식필수설명
panel_idnumber
필수
티켓을 옮길 단일 패널의 ID(패널 목록 참고).
keep_permissionsboolean
선택
새 패널의 팀에 더해 채널의 기존 역할 권한도 그대로 둘지 여부(기본값 true). false로 두면 역할 접근 권한을 새 패널의 지원팀만 남기고 초기화합니다.

티켓 방식이 같아야 합니다. 채널 티켓은 채널 방식 패널로만, 스레드 티켓은 스레드 방식 패널로만 옮길 수 있습니다. 패널을 바꾸면 채널 이름도 바뀌기 때문에 Discord의 제한에 따라 10분에 두 번 정도만 가능합니다. 이 엔드포인트도 같은 기준으로 제한되며, 넘기면 429와 retry_after를 돌려줍니다.

요청 예시
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
응답 예시
{
  "message": "Panel switched to `Billing` successfully.",
  "ticket_id": 42,
  "panel_id": 2,
  "keep_permissions": true
}