Skip to main content
POST
Create one idempotent actor-authored message in a canonical chat

Authorizations

Authorization
string
header
required

Runtime context-key (rctx_*) issued by the Ravi gateway. Required for every non-open scope. Bootstrap the first key with ravi daemon init-admin-key; rotate, derive, and revoke via the ravi context family. Specs: runtime/context-keys, sdk/auth.

Body

application/json
actorId
string
required

Canonical actor id

Required string length: 1 - 128
Pattern: ^[A-Za-z0-9][A-Za-z0-9._~-]{0,127}$
chatId
string
required

Canonical chat id

Pattern: ^chat_[0-9a-f]{24}$
clientMessageId
string
required

Caller-owned message id

Required string length: 1 - 128
Pattern: ^[A-Za-z0-9][A-Za-z0-9._~-]{0,127}$
content
string
required

Message text

Required string length: 1 - 1000000

Response

Success — body conforms to the @Returns schema.

clientMessageId
string
required
disposition
enum<string>
required
Available options:
created,
duplicate
message
object
required
messageId
string
required