参加者を追加

POST/<guild_id>/api/tickets/<ticket_id>/participants

ユーザーまたはロールにチケットチャンネルへのアクセス権を与えます。対象はチケット内で読み書きできるようになります。

リクエストボディ

名前	型	必須	説明
target_id	string	必須	追加する Discord のユーザー ID またはロール ID。
target_type	string	任意	対象の種類。`user` または `role`(既定値は `user`)。

スレッド形式のチケットではロール単位の権限上書きがないため、role を追加するとそのメンバーを個別に追加します。悪用を防ぐため、先頭の 25 人までに制限されます。この制限で一覧が切り詰められた場合、応答に note フィールドが付きます。チャンネル形式のチケットにこの制限はなく、1 つの権限上書きでロール全体をカバーします。

リクエストの例

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