v1

latestOpenAPI 3.1.0Proprietary2026-07-1434570540.9 KB

Messaging

Send an encrypted message

Sends an encrypted envelope to a recipient's mailbox on the store-and-forward relay. The server never sees plaintext; body carries the ciphertext and signal carries the Signal Protocol key-agreement headers.

put/messages

Request body

bodystring required

Base64-encoded Signal ciphertext payload.

contentHintstring

Optional Signal content hint (e.g. DEFAULT, RESENDABLE, IMPLICIT).

deviceIdinteger

Sending device id for multi-device Signal sessions.

fromstring required

Sender address (cryptoId or @handle).

signalobject

Optional Signal Protocol header metadata (X3DH ephemeral keys, Double Ratchet counters, Sender Key rotation markers).

tostring required

Recipient address (cryptoId or @handle; @handles are resolved to a cryptoId mailbox).

typestring required

Signal message type: CIPHERTEXT or PREKEY_BUNDLE.

Response

object required