Delete Support Agent

DELETE 
/api/support/admin/agents/:agent

Revokes a support seat. The revoke is soft: the seat row stays, with its profile and notification flags, and is_active becomes false, so it still appears in List Support Agents (use filter[is_active]=false) and can be restored later with Update Support Agent (is_active: true) or by granting the same email again. Tickets assigned to the agent are left as they are.

Required scope: support:write

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

The last effective admin cannot be revoked; the request is refused with 422 and the error is reported under agent.

Response: 204 with an empty body.

Authentication: Bearer token with the support:write scope, or an authenticated session, from a caller with an active support role who also holds the support admin role. No tenant context — this endpoint is central.

Request

Responses

204

No Content

401

Unauthorized

Response Headers

Content-Type

403

Forbidden

Response Headers

Content-Type

404

Not Found

Response Headers

Content-Type

422

Unprocessable Content

Response Headers

Content-Type

429

Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.