Tutorial

Using the API

Authenticate and make programmatic requests to the Elis AI backend.

Create an API key

Go to Settings → API Keys and create a new key (see the Settings tutorial for details). Copy the key value.

Make your first request

Send a request to the chat endpoint with your API key in theX-API-Key header:

curl -X POST https://your-domain/api/chat \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"message": "Hello", "conversation_id": null}'

Handle the streaming response

The response is a Server-Sent Events (SSE) stream. Each event contains a token chunk. Accumulate chunks to build the full response.

data: {"token": "Hello"}
data: {"token": " there"}
data: {"token": "!"}
data: [DONE]

Continue the conversation

Pass the conversation_id from the response in subsequent requests to continue the same conversation with full context.

Tip:You can also authenticate with a JWT token in the Authorization: Bearer header instead of an API key.

Tip:Need to manage recurring research widgets programmatically? See the Automations API tutorial for creating widgets, triggering runs, streaming events, and downloading PDF/Excel exports via REST.

Tip:Organization policy note: internet controls apply to web-sourced tools only. Linked REST API data source calls are managed separately through organization data source configuration.