Chat and conversations API

Summary

The chat API lets integrations list conversations the token user belongs to, read messages, and post new messages. You cannot access conversations you are not a member of.

Who this is for

Developers and integrators building automations with Elevale API personal access tokens.

The chat API lets integrations list conversations the token user belongs to, read messages, and post new messages. You cannot access conversations you are not a member of.

Endpoints

GET /conversations - list your conversations in the workspace
GET /conversations/{conversationId}/messages - list messages
POST /conversations/{conversationId}/messages - send a message

Scopes

chat:read for GET; chat:write for POST.

List messages (GET /conversations/{conversationId}/messages)

Accepts limit (default 50, max 100) and offset for pagination.

Send message body (POST)

content (required) - message text string

curl -X POST "https://api.elevale.app/v1/workspaces/{workspaceId}/conversations/{conversationId}/messages" \
  -H "Authorization: Bearer elv_pat_..." \
  -H "Content-Type: application/json" \
  -d '{"content":"Update from integration: deal closed."}'