Documentation

Learn TicketsX faster

Setup guides, the full command reference, Premium features, and the REST API in one place.

Add a Participant

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

Grant a user or role access to a ticket channel. The target receives read and send permissions in the ticket.

Request Body

NameTypeRequiredDescription
target_idstringrequiredDiscord user ID or role ID to add.
target_typestringoptionalType of target. Either user or role (default user).

On thread tickets, threads have no role overwrites, so adding a role adds its members individually — capped at the first 25 members as an abuse guard. When the cap truncates the list, the response includes a note field. Channel tickets have no such limit (one permission overwrite covers the whole role).

Example request
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