Send a message (timeline item) to a conversation

Send a new message (timeline item) to an existing conversation.

POST
/v1/messages

Header Parameters

Authorization?string

Private API key in Bearer token format. Use this for server-to-server authentication. Format: Bearer sk_[live|test]_...

Match^Bearer sk_(live|test)_[a-f0-9]{64}$
X-Public-Key?string

Public API key for browser-based authentication. Can only be used from whitelisted domains. Format: pk_[live|test]_...

Match^pk_(live|test)_[a-f0-9]{64}$
X-Visitor-Id?string

Visitor ID from localStorage.

Match^[0-9A-HJKMNP-TV-Z]{26}$
conversationIdstring

ID of the conversation to send the timeline item to

item

Response Body

application/json

application/json

curl -X POST "https://api.cossistant.com/v1/v1/messages" \  -H "Content-Type: application/json" \  -d '{    "conversationId": "string",    "item": {      "text": "string"    }  }'
{
  "item": {
    "id": "string",
    "conversationId": "string",
    "organizationId": "string",
    "visibility": "public",
    "type": "message",
    "text": "string",
    "tool": "string",
    "parts": [
      {
        "type": "text",
        "text": "string"
      }
    ],
    "userId": "string",
    "aiAgentId": "string",
    "visitorId": "string",
    "createdAt": "string",
    "deletedAt": "string"
  }
}
{
  "error": "string"
}