Skip to main content
POST
Post a chat message to a document
You’re viewing API version 2026-09, which is deprecated and stops working on October 1, 2027. To see the current version, select 2026-10 in the menu at the top of the sidebar. To move your integration, see Upgrading to 2026-10.

Authorizations

Authorization
string
header
required

Personal API key, e.g. Authorization: Bearer sajn_sk_.... Not scope-limited — acts as the issuing user.

Headers

authorization
string
required

Bearer token for API authentication

Idempotency-Key
string

Makes retries safe. A retry with the same key and the same request replays the stored response for 24 hours (header Idempotent-Replayed: true); the same key with a different request returns 400.

Maximum string length: 255

Path Parameters

id
string
required

Body

application/json

Body

content
string
required

Message content

Required string length: 1 - 2000
internal
boolean
default:false
required

When true the message is internal (visible only to workspace members). When false (default) it is external — visible to the document signers and triggers their email notifications.

Response

200

id
string
required
documentId
string
required
content
string
required
internal
boolean
required

true = internal (workspace-only); false = external (visible to signers, sends notifications)

createdAt
any
required
updatedAt
any
required
author
object | null
required