Post a message
An answer, a question, a reference or an internal note, in Markdown, with links. Marked "via API" for everyone who sees it. 403 `cannot_post`; 400 `empty_message`.
An answer, a question, a reference or an internal note, in Markdown, with links.
Marked "via API" for everyone who sees it. 403 cannot_post; 400 empty_message.
ApiKeyAuthorizationBearer <token>An API key from your organization's API Keys page in Cerclen.
request_id*Request Iduuiddeal_id*Deal Iduuidapplication/json- body
internal?InternalKeep it to your side, such as a draft for a colleague to check; an internal_note is kept to your side anyway. Only the side that runs the list keeps anything to itself: everything the other side posts is shared.
falsekind?MessageKindDrives triage and the UI, never the status machine (ADR-0003).
"response""response""question""reference""internal_note"links?array<>items <= 20partial?PartialAnswers the request in part; it moves to partial.
falsetext?TextIn Markdown.
length <= 20000""update_status?Update StatusA response moves the request to partial or complete; false leaves it.
trueSuccessful Response
application/json- response
An answer, a question, a reference or a note in a request's conversation.
author*|nullfiles*array<>format*BodyFormatmarkdown, or plain for an emailed reply.
"text""markdown"id*Idinternal*InternalSeen by its author's side only.
kind*MessageKindDrives triage and the UI, never the status machine (ADR-0003).
"response""question""reference""internal_note"on_behalf*On BehalfConfirmed by a colleague for the person who emailed it.
partial*PartialA partial answer: more is to come.
posted_at*|nullsource*MessageSourceWhere it came from: web, email, import or api.
"email""web""import""api"text*Textcurl -X POST 'https://app.cerclen.com/api/v1/deals/497f6eca-6276-4993-bfeb-53cbbbba6f08/requests/497f6eca-6276-4993-bfeb-53cbbbba6f08/messages' \ -H "Authorization: Bearer $CERCLEN_KEY" \ -H 'Content-Type: application/json' \ -d '{ "links": [ { "label": "FY2025 audit", "url": "https://dataroom.example.com/f/123" } ], "text": "The FY2025 audited accounts are in the data room."}'{ "author": { "email": "string", "id": "string", "name": "string" }, "files": [ { "content_type": "string", "downloadable": true, "kind": "file", "name": "string", "size": 0, "url": "string", "version_id": "string" } ], "format": "text", "id": "string", "internal": true, "kind": "response", "on_behalf": true, "partial": true, "posted_at": "2019-08-24T14:15:22Z", "source": "email", "text": "string"}