Update a department
/support/departments/{department_id}Renames a support department.
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.
Autonomous mode: the API credential secret, sent as a bearer token. Credential secrets are identified by a fixed prefix.
In: header
Path Parameters
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.
Expected revision of the resource, in the same format as the ETag header (W/"<type>:<id>:<revision>"). If the resource has changed since that revision, the request fails with 412 and the revision_mismatch error code. When omitted, the update is applied to the current revision.
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 <= 64Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X PATCH "https://example.com/support/departments/string" \ -H "Content-Type: application/json" \ -d '{}'Retrieve a department GET
Retrieves a support department by its public ID. The response includes an `ETag` representing the current revision. Send this value in the `If-Match` header when updating the department to avoid overwriting a newer version.
Delete a department DELETE
Deletes a support department. A department that still has tickets assigned to it, including deleted tickets, cannot be deleted. The request is rejected with the `state_conflict` error code and the department and its tickets remain unchanged. The `tickets_count` field of the department reflects these tickets.