Deskhero Developer Hub
Back to deskhero.com
Lists

Delete

Soft deletes one custom list. It requires FULL permission on the list, system lists are refused, and so is a list that any field still uses as its multi option source. The list's entries are not deleted along with it, they are only left without a reachable list.

DELETE /api/{tenant:minlength(2)}/v{version:apiVersion}/lists/{id}
Authorisation
Minimum role: ADMIN

Request arguments

Name Type Source
idInt32
Request body example

Response

Status
200 (OK)
Type
DTO_acknowledgement
Wrapper
DTO_response_wrap
Other statuses
400 (BadRequest), 403 (Forbidden)
Response body example
DTO_acknowledgement
NameTypeReadOnlyDescription
messageStringMessage

Generated Aug 4, 2026 18:37