Append a chat message

POST

https://api.hmsovereign.com/api/v1/chats

Chats

Last modified:2026-04-23 10:43:17

Maintainer:Not configured

Store a single chat message for a contact.

Chats are a lightweight, developer-first storage primitive. VoiceDock keeps the
messages — your application keeps the LLM logic, tools, and channel wiring
(Meta Cloud API, widget, SMS gateway, etc.). Pair with GET /chats/context
to share history between chat channels and voice agents.

Messages are append-only; update by inserting a new message and delete
individually via DELETE /chats/{id}.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/jsonRequired

Examples

Responses

🟢201

application/json

Message stored

Body

🟠400

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.hmsovereign.com/api/v1/chats' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "contact_id": "string",
    "channel": "string",
    "role": "user",
    "content": "string",
    "agent_id": "2b1e3b65-2c04-4fa2-a2d7-467901e98978",
    "metadata": {}
}'

Response Example

201 - Example 1

{
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "agent_id": "2b1e3b65-2c04-4fa2-a2d7-467901e98978",
    "contact_id": "+31612345678",
    "channel": "whatsapp",
    "role": "user",
    "content": "string",
    "metadata": {
        "provider_message_id": "wamid.ABC",
        "attachments": []
    },
    "created_at": "2019-08-24T14:15:22.123Z"
}

Modified at 2026-04-23 10:43:17

Health check

List chat messages