Plattformsdokumentation

Chat and conversations API

Chat and conversations API

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."}'

Related

Personal access tokens (PATs) · Scopes and permissions