Delete a department
/support/departments/{department_id}Deletes a support department.
A department that still has tickets assigned to it, including deleted tickets, cannot be deleted unless unlink_tickets=true is sent. Without that flag the request is rejected with the state_conflict error code. With the flag, tickets are kept and unlinked, matching the dashboard, including deleted tickets, which the API does not list. To keep tickets in a department, move them first with PATCH /support/tickets/{ticket_id} (department_id).
Credential: the API credential secret, sent as a bearer token. Credential secrets are identified by a fixed prefix.
In: header
Path Parameters
Public ID of the department, prefixed with dep_.
Query Parameters
When true, unassign tickets (including those in the trash) and delete the department.
Header Parameters
Client-generated key that makes the request safe to retry. Must be 1 to 128 characters from [A-Za-z0-9._:-]. Optional on this operation; when sent, a malformed key returns idempotency_key_invalid, and repeating the request with the same key and the same body returns the stored result with Idempotent-Replayed: true.
Optional client-generated identifier of the request, up to 64 characters from [A-Za-z0-9._-]. Echoed back in the response and recorded in the request log; it never replaces the server-generated X-Request-Id.
length <= 64Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X DELETE "https://example.com/support/departments/string"Update a department PATCH
Updates a support department. Omitted fields are left unchanged. Send `admin_id` as `null` to clear the assigned administrator. The `If-Match` header is optional. When supplied, it must contain the `ETag` returned by the retrieve operation; if the department has changed since then, the update is rejected.
Comments9
Next Page