Errors are returned as JSON:API error documents. The HTTP status code in the response line reflects the error category. The most common error codes are:
The request body is missing required fields, contains an invalid value, or the upload failed. The title field in the error object contains a human-readable message.
No valid Bearer token was supplied. Ensure the Authorization header is present and the token has not been revoked.
The authenticated user is not an ATS manager, does not have the required permission for the requested operation, or the referenced resource (ticket, post, attachment) does not exist. ATS returns 403 rather than 404 for missing resources to avoid leaking information about IDs.
Returned by the attachment download endpoint when the physical file is missing from disk even though the database record exists.
An unexpected server-side error occurred (e.g. a database failure during save).
A typical error response body:
{ "errors": [ { "title": "You are not authorised to view this resource.", "detail": "", "status": "403" } ]}