Delete a Queue View

Permanently delete a queue view from your SysAid account. This action is irreversible. Every delete first requires the caller to have permission to save personal queue views; without it, SysAid answers 403, even for an ID that does not exist. The caller may delete their own "PRIVATE" queue views. Deleting a "PUBLIC" queue view requires the caller to be a SysAid Admin. Attempting to delete another user's "PRIVATE" queue view, or a "PUBLIC" queue view without the Admin role, also answers 403. Deleting a "PUBLIC" queue view also clears the default queue view of every user whose default queue view pointed at it. SysAid refuses to delete the caller's own default queue view, and refuses when the caller has no default queue view configured; both cases answer 409, with SysAid's own message. Deleting a queue view that was already deleted, or that never existed, answers 404. The ID of an asset queue view is also accepted here and deletes that asset queue view, even though the Get and List operations only return service record queue views. Other upstream statuses may also be passed through unchanged, as with the Get and List operations.

Path Params
integer
required
1 to 2147483647

The unique identifier of the queue view in SysAid, as an integer from 1 to 2147483647.

Responses
204

The queue view was deleted.

502

SysAid returned an unexpected or failed response. Other upstream 4xx/5xx statuses may also be passed through.

Language
Credentials
Bearer
JWT
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json