API Reference

The platform API

Three groups of operations: managing conversations, sending messages (including streaming), and the RAG index. The full specification is public in OpenAPI 3.1.

openapi.json Quick start guide

Base URL and authentication

Base URL

https://api.slatech.ai/v1

Authentication

Bearer token in the request header:

Authorization: Bearer <API_KEY>

Version

OpenAPI 3.1.0, API version 1.0.0. The spec is the source of truth; this page is a readable summary of it.

Endpoints

MethodPathWhat it does
POST/conversationsCreate a new conversation.
GET/conversations/{conversationId}Read a conversation and its message history.
POST/chat/messagesSend a single message and get a full reply.
POST/chat/messages/streamStream a reply as Server-Sent Events.
POST/rag/documentsAdd or update a document in the RAG index.
DELETE/rag/documents/{documentId}Remove a document from the index.
POST/rag/searchSearch the index without invoking a language model.

Your first request

Send a message and get a reply, no SDK required:

curl -X POST https://api.slatech.ai/v1/chat/messages \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"message":"What are your opening hours?"}'

What the spec does not cover

The public specification covers conversations, messages, and RAG. Webhooks and custom actions are not part of it: they are built per integration, around the systems being connected. If you need them, that is part of the scoping conversation. We don't list endpoints here that the spec doesn't have.

What we connect to Talk to us