Skip to main content

Remove Support Ticket Participant

DELETE 

/api/support/tickets/:ticket/participants/:participant

Removes a watcher or CC from the ticket by its ticket-scoped participant id. Unlike Remove Support Ticket Watcher, which needs the watcher's user id, this works for any non-requester participant — including an outside email address that was CC'd and has no SKU.io login. The removal is recorded on the ticket's timeline as a watcher_removed event.

Required scope: support:write

Grant this scope to your token under Settings → Developer → Personal Access Tokens.

The requester cannot be removed from their own ticket (422). A participant id that belongs to a different ticket is treated as not found (404).

Authentication: Bearer token with the support:write scope, or an authenticated session, from a user who can view the ticket. A caller whose support seat is the viewer role is refused with 403 — a viewer reads everywhere and writes nowhere, on the customer side as well as in the console. Requires the X-Tenant-Id header (or a tenant subdomain).

Request

Responses

No Content