Deskhero Developer Hub
Back to deskhero.com
Files

Delete

Marks one or more files for deletion; the files are removed from storage later by a background job, not during this call. Files that are still referenced by a ticket, a conversation entry, a list entry or an article are skipped silently, and the call fails when an id is unknown, when a file is already marked for deletion, or when every file in the request is in use.

DELETE /api/{tenant:minlength(2)}/v{version:apiVersion}/files/delete
Authorisation
Minimum role: USER

Request arguments

Name Type Source
inputsDTO_file_delete[]Body
Request body example

Response

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

Generated Aug 4, 2026 18:37