Sign in

v1

latestOpenAPI 3.0.32026-08-0425108247.7 KB
Messages

Create a conversation message

Creates a message in a conversation using the authenticated API-key workspace membership as the author.

post/conversations/{conversationId}/messages

Path parameters

conversationIdstring required

Conversation identifier.

Conversation identifier.

Headers

Idempotency-Keystring required

Idempotency key.

Required idempotency key for safely retrying this write.

Request body

markdown_contentstring nullable required

Message markdown content.

explicit_context_message_idsstring[]

Message identifiers to include as explicit context.

image_urlsstring[]

Image URLs to attach to the message.

suppressed_link_preview_urlsstring[]

URLs whose link previews should be suppressed.

initiator_idstring nullable

Initiating workspace member identifier.

thread_root_idstring nullable

Thread root message identifier.

replied_to_message_idstring nullable

Immediate parent message identifier inside an existing thread. For the first reply to a root message, send thread_root_id only; if replied_to_message_id equals thread_root_id, the server normalizes it as the first reply.

call_root_idstring nullable

Call root identifier.

optimistic_idstring

Client optimistic identifier.

client_request_idstring nullable

Legacy body idempotency value. Public v1 clients should use the Idempotency-Key header.

author_idstring

Ignored legacy body author workspace member identifier. Deprecated: the authenticated API-key workspace member is always the author.

Response

Created message.

legacy_dataobject nullable

Legacy extended conversation message. New clients should read the standard data message result.

successboolean required

Compatibility command flag.

Example response

{
  "data": {
    "authorWorkspaceMembershipId": "01jzn7e61x3a7v9h2r7t2m3q4p",
    "author_id": "01jzn7e61x3a7v9h2r7t2m3q4p",
    "conversation_id": "01jzn7e61x3a7v9h2r7t2m3q4p",
    "created_at": "2026-05-14T08:00:00.000Z",
    "id": "01jzn7e61x3a7v9h2r7t2m3q4p"
  }
}