Mailboxes that feed desk: the comms mailbox, default space and type, routes (desk:admin)
GET /api/desk/v1/mail-sources
Module: Desk · operationId: listMailSources · Tag: Mail · Auth: access token (Authorization: Bearer <accessToken>)
Responses
- 200 Mail sources (
application/json)
Fields of the 200 answer:
items(array of MailSource, required)defaultSpaceId(string, required): Space of tickets no route matchedmailboxId(string, required): Mailbox id in commsaiRouting(object): When no route matches, the AI chooses the space of a new ticket among the candidates (described in the admin's words); below the threshold, or when nothing fits, the default space is used.candidates(array of object): Spaces the AI may choosedescription(string, required): What belongs in the space, in the admin's words (max length 500)spaceId(string, required): Space the AI may choosetypeId(string): Type of tickets created there
enabled(boolean): The AI chooses the space when no route matchedthreshold(number): Default 0.7 (max 1)
defaultTypeId(string, nullable): Empty uses the space''s default typeenabled(boolean): Whether the mailbox feeds deskid(string, read-only): Id of the mail sourcename(string): Name of the mail sourcereplyEnabled(boolean): Agents may answer by mail through this mailboxroutes(array of object): Routes in order; the first matching one decides space and typecondition(string, required): When the route takes a mail: a bool expression in the flow language overtrigger.data, the facts of the received mail (from,fromDomain,to,subject,body,hasAttachments,mailbox;GET /conditions/catalog,mail). Required. One that cannot be evaluated for a mail does not hold (the next route, at last the default space). (max length 4000)spaceId(string, required): Space of the route's ticketsname(string): Name of the routetypeId(string): Type of the route's tickets (default: the space's)
updatedAt(string (date-time), read-only): When it was last changedupdatedBy(string, read-only): Login (e-mail) of who last changed itversion(integer): Version of the mail source; send it back on change
Example 200 answer:
{
"items": [
{
"aiRouting": {
"candidates": [],
"enabled": false,
"threshold": 0.8
},
"defaultSpaceId": "9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c00",
"defaultTypeId": "5d2e3f4a-6b7c-4d8e-9f0a-2b3c4d5e6f02",
"enabled": true,
"id": "3f0a1b2c-4d5e-4f6a-9b8c-0d1e2f3a4b11",
"mailboxId": "3f0a1b2c-4d5e-4f6a-9b8c-0d1e2f3a4b01",
"name": "support@muster-it.example",
"replyEnabled": true,
"routes": [],
"updatedAt": "2026-10-20T13:40:00Z",
"updatedBy": "elias.gruber@muster-it.example",
"version": 3
}
]
}
Example request
curl -X GET 'https://api.mbcom.cloud/api/desk/v1/mail-sources' \
-H "Authorization: Bearer $ACCESS_TOKEN"