13.6
참여자 추가
POST
/<guild_id>/api/tickets/<ticket_id>/participants사용자나 역할에 티켓 채널 접근 권한을 줍니다. 대상은 그 티켓에서 읽기와 쓰기 권한을 받습니다.
요청 본문
| 이름 | 형식 | 필수 | 설명 |
|---|---|---|---|
| target_id | string | 필수 | 추가할 Discord 사용자 ID 또는 역할 ID. |
| target_type | string | 선택 | 대상의 종류. user 또는 role(기본값 user). |
스레드 티켓에는 역할 단위 권한 설정이 없기 때문에, role을 추가하면 소속 구성원을 한 명씩 추가하며 남용을 막으려고 앞에서부터 25명까지만 처리합니다. 목록이 잘리면 응답에 note 필드가 들어갑니다. 채널 티켓에는 이런 제한이 없습니다(권한 설정 하나로 역할 전체가 처리됩니다).
요청 예시
curl -X POST \
-H "Authorization: Bearer <API_TOKEN>" \
-H "Content-Type: application/json" \
-d '{"target_id":"111222333","target_type":"user"}' \
https://api.ticketsx.xyz/<guild_id>/api/tickets/<ticket_id>/participants