Email Management API¶
Manage mailboxes and quarantined messages, and clawback messages from M365 inboxes.
See the guide for a narrative walkthrough of this API.
Base URL¶
https://api-{dataRegion}.central.sophos.com/email/v1 — Regional service in the production environment.
| Variable | Description | Default | Allowed values |
|---|---|---|---|
dataRegion | The data region where tenant data is stored. | eu01 | eu01, eu02, us01, us03, ca01, au01, jp01, in01, br01, ae01 |
Authentication¶
Every request carries an Authorization: Bearer header with an access token obtained through the client-credentials flow — see Get started.
Required permissions¶
This API's operations require one or more of the following, depending on the operation — see each operation's own page for the exact requirement:
xgemail.msghistory:readxgemail.msghistory:write
Operations¶
Clawback¶
See Guide for more on Clawback.
- Clawback message
POST/messages/{id}/clawback - Message status
GET/messages/{id}/status
Mailbox Management¶
- Query Mailboxes
GET/mailboxes - Add mailbox
POST/mailboxes - Add mailboxes
POST/mailboxes/bulk - Delete mailboxes
POST/mailboxes/delete - Get mailbox
GET/mailboxes/{id} - Update name
PATCH/mailboxes/{id} - Delete mailbox
DELETE/mailboxes/{id} - Change aliases
POST/mailboxes/{id}/aliases - Bulk privilege
POST/mailboxes/{id}/bulksender-privilege-request - Change delegates
POST/mailboxes/{id}/delegates - Change DL owners
POST/mailboxes/{id}/distribution-list-owners
Post-Delivery Quarantine¶
See Guide for more on Post-Delivery Quarantine.
- Download job status
GET/post-delivery-quarantine/downloads/{downloadId}/status - Quarantine delete
POST/post-delivery-quarantine/messages/delete - Quarantine release
POST/post-delivery-quarantine/messages/release - Search quarantine
POST/post-delivery-quarantine/messages/search - Get attachments
GET/post-delivery-quarantine/messages/{id}/attachments - Download attachments
POST/post-delivery-quarantine/messages/{id}/attachments/download - Preview message
GET/post-delivery-quarantine/messages/{id}/preview
Quarantine¶
See Guide for more on Quarantine.
- Download job status
GET/quarantine/downloads/{downloadId}/status - Quarantine delete
POST/quarantine/messages/delete - Quarantine release
POST/quarantine/messages/release - Search quarantine
POST/quarantine/messages/search - Get attachments
GET/quarantine/messages/{id}/attachments - Download attachments
POST/quarantine/messages/{id}/attachments/download - Reattach attachments
POST/quarantine/messages/{id}/attachments/reattach - Strip attachments
POST/quarantine/messages/{id}/attachments/strip - Preview message
GET/quarantine/messages/{id}/preview - Get urls
GET/quarantine/messages/{id}/urls
Download¶