Add a comment (public) or note (internal) (desk:write, reporter role)
POST /api/desk/v1/items/{ref}/entries
Module: Desk · operationId: addItemEntry · Tag: Activity · Auth: access token (Authorization: Bearer <accessToken>)
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
ref |
path | string | yes | Item id or number |
Request body
application/json (required)
body(string, required): MarkdownaiGenerated(boolean)visibility(string): (one ofinternal,public)
Example:
{
"body": "Controller zeigt AP-207 mit ständigen Neustarts (PoE-Budget am Switch im Technikraum 2. OG überschritten).",
"visibility": "internal"
}
Responses
- 201 Created. kind is email_out when a public comment was mailed to the customer; mailNote is set only for a public comment that was not mailed (never for internal notes) (
application/json)
Fields of the 201 answer:
aiGenerated(boolean): The text was written with AI helpauthorKind(string): external: a third party who answered an internal mail (the entry is internal) (one ofagent,requester,system,ai,rule,external)authorName(string): Name of the authorauthorRef(string): Login (e-mail) of the authorautomated(boolean): Written by a rule or service; never counts as a first responsebody(string): Markdownchannel(string): Where the entry came from (one ofui,mail,portal,api)createdAt(string (date-time)): When the entry was writteneditedAt(string (date-time)): When the entry was last editedid(string): Id of the entryitemId(string): Item the entry belongs tokind(string): comment, email_in, email_out or systemmail(object): Mail of email_in and email_out entries: direction, from, to, cc, subject, deliveryState (draft, queued, sent, delivered, deferred, bounced, failed, suppressed), recipientStates, attachmentsinReplyToEntryId(string): Outgoing mails: the mail entry of the ticket it answers; a draft keeps it when it is saved or sent without inReplyToEntryIdincludeChain(boolean): Sent mails: whether the earlier mails of the ticket went out below the textmainText(string): Received mails: the text without quoted history, signature, closing and legal footer; missing when nothing was cut or the entry was edited.bodystays the full text.thirdParty(boolean): An internal mail to or from third parties (suppliers, …; sent with visibility internal or answering one). An internal mail without it – a customer mail a merge or move hid – still belongs to the customer's thread.trimMethod(string): How mainText was found: rules on the text, or the AI for a long mail (settings.mail.aiTrim) (one ofheuristic,ai)
mailNote(string): why no mail was sent for a public comment (work_type: the ticket type has the work focus, comments on it are never mailed) (one ofno_mailbox,no_recipient,mail_unavailable,work_type)movedFromId(string): Item the entry was moved fromvisibility(string): internal: only staff see it; public: the requester sees it too (one ofinternal,public)
Example 201 answer:
{
"aiGenerated": false,
"authorKind": "agent",
"authorName": "Lukas Wimmer",
"authorRef": "lukas.wimmer@muster-it.example",
"automated": false,
"body": "Controller zeigt AP-207 mit ständigen Neustarts (PoE-Budget am Switch im Technikraum 2. OG überschritten). AP-201 läuft stabil.",
"channel": "ui",
"createdAt": "2026-11-17T08:40:00Z",
"id": "1b8c9d0e-2f3a-4b4c-9d6e-8f9a0b1c2d03",
"itemId": "4a1b2c3d-5e6f-4a7b-8c9d-1e2f3a4b5c01",
"kind": "comment",
"visibility": "internal"
}
Example request
curl -X POST 'https://api.mbcom.cloud/api/desk/v1/items/string/entries' \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H 'Content-Type: application/json' \
--data '{"body":"Controller zeigt AP-207 mit ständigen Neustarts (PoE-Budget am Switch im Technikraum 2. OG überschritten).","visibility":"internal"}'