Skip to Content

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 move your integration, see Upgrading to 2026-10.
POST
/api/v1/documents/{id}/chat

Post a message to a document's chat. Set internal: true to keep it visible only to workspace members; omit it or set internal: false to post an external message that is visible to the document's signers and triggers their email notifications.

Authorization

headerAuthorizationBearer <token>

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

Path Parameters

id*string

Header Parameters

authorization*string

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.

Lengthlength <= 255

Request Body

Body

application/json
  1. body
content*string

Message content

Length1 <= length <= 2000
internal*boolean

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.

Defaultfalse

Response Body

200

application/json
  1. response
id*string
documentId*string
content*string
internal*boolean

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

createdAt*unknown
updatedAt*unknown
author*|null
Example Request
curl -X POST 'https://app.sajn.se/api/v1/documents/string/chat' \  -H 'authorization: string' \  -H 'Content-Type: application/json' \  -d '{  "content": "string",  "internal": false}'
Example Response
{  "id": "string",  "documentId": "string",  "content": "string",  "internal": true,  "createdAt": null,  "updatedAt": null,  "author": {    "type": "USER",    "id": "string",    "name": "string",    "email": "string"  }}

Was this page helpful?