13.15
티켓의 패널 바꾸기
POST
/<guild_id>/api/tickets/<ticket_id>/switch-panel티켓을 다른 단일 패널로 옮깁니다. /switchpanel 명령어에 해당하는 API입니다. 티켓 이름이 새 패널의 이름 규칙에 맞게 바뀌고, 채널 티켓이라면 새 패널의 카테고리로 옮겨지며, 새 패널의 지원팀에 접근 권한이 생깁니다. `switch_panel` 권한이 필요합니다(기본값은 꺼짐).
요청 본문
| 이름 | 형식 | 필수 | 설명 |
|---|---|---|---|
| panel_id | number | 필수 | 티켓을 옮길 단일 패널의 ID(패널 목록 참고). |
| keep_permissions | boolean | 선택 | 새 패널의 팀에 더해 채널의 기존 역할 권한도 그대로 둘지 여부(기본값 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
}