Skip to main content
POST
Create a conversation message

Authorizations

x-api-key
string
header
required

Workspace API key. Current accepted keys use the ando_sk_ prefix.

Headers

Idempotency-Key
string
required

Required idempotency key for safely retrying this write. Idempotency key.

Maximum string length: 255

Path Parameters

conversationId
string
required

Conversation identifier.

Body

application/json

Create a conversation message. The authenticated API-key workspace member is the author; author_id is accepted only for legacy body compatibility and is ignored.

markdown_content
string | null
required

Message markdown content.

explicit_context_message_ids
string[]

Message identifiers to include as explicit context.

Message identifier.

image_urls
string<uri>[]

Image URLs to attach to the message.

Image URL.

URLs whose link previews should be suppressed.

URL.

initiator_id
string | null

Initiating workspace member identifier.

thread_root_id
string | null

Thread root message identifier.

replied_to_message_id
string | null

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_id
string | null

Call root identifier.

optimistic_id
string

Client optimistic identifier.

client_request_id
string | null

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

author_id
string
deprecated

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

Response

Created message.

Create-message response with the standard public data envelope plus legacy compatibility aliases.

data
object
required

Public message result. This intentionally omits reply lineage fields such as thread_root_id and replied_to_message_id; use the thread replies route and its thread_root_id payload field to validate thread grouping.

success
boolean
required

Compatibility command flag.

legacy_data
object | null

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