Deskhero Developer Hub
Back to deskhero.com
Mailboxes

Delete

Soft deletes the mailbox and its stored authentication, and cancels the Microsoft Graph subscription that pushed new mail in (Google subscriptions are left to expire on their own). Tickets, conversations and imports already created from the mailbox are left untouched.

DELETE /api/{tenant:minlength(2)}/v{version:apiVersion}/mailboxes/{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