IllumiChat - AI-Powered Chat Platform

The IllumiChat API lets you manage assistants, conversations, contacts, tickets, and more. All endpoints follow REST conventions and return JSON responses.

Base URL

https://app.illumichat.com/api

Request Format

Use Content-Type: application/json for request bodies
Include authentication credentials with every request (see Authentication)
URL path parameters are denoted with {paramName} in the endpoint documentation

Example Request

curl -X GET https://app.illumichat.com/api/assistants \
  -H "Authorization: Bearer <your-token>" \
  -H "Content-Type: application/json"

const response = await fetch("https://app.illumichat.com/api/assistants", {
  headers: {
    Authorization: "Bearer <your-token>",
    "Content-Type": "application/json",
  },
});

const data = await response.json();

import requests

response = requests.get(
    "https://app.illumichat.com/api/assistants",
    headers={
        "Authorization": "Bearer <your-token>",
        "Content-Type": "application/json",
    },
)

data = response.json()

Response Format

All successful responses return JSON. The structure depends on the endpoint:

// Single resource
{
  "id": "abc123",
  "name": "My Assistant",
  "createdAt": "2025-01-15T10:30:00Z"
}

// Collection
[
  { "id": "abc123", "name": "Assistant A" },
  { "id": "def456", "name": "Assistant B" }
]

Error responses use a consistent format described in Errors & Status Codes.

Authentication Methods

Method	Use Case	Details
Session cookie	Browser-based apps	Set automatically after Auth0 login
Bearer token	Server-to-server	Pass in `Authorization` header
Public (no auth)	Widget & SMS webhooks	Rate-limited by IP or assistant

See Authentication for full details.

API Sections

Authentication

Session cookies, API keys, and public endpoints.

Errors & Status Codes

Error format, HTTP codes, and handling patterns.

Rate Limiting

Request limits, widget quotas, and backoff strategies.

Endpoint Reference

Browse individual endpoint documentation generated from the OpenAPI spec.

Key Endpoint Groups

Group	Base Path	Description
Assistants	`/api/assistants`	Create, update, and manage AI assistants
Chat	`/api/chat`	Send messages and stream responses
Projects	`/api/projects`	Manage projects and documents for RAG
Contacts	`/api/contacts`	Create and manage contacts
Tickets	`/api/tickets`	Support ticket lifecycle
Widget	`/api/widget/{assistantId}`	Public widget endpoints
SMS	`/api/sms`	Twilio webhook endpoints
Webhooks	`/api/webhooks`	Manage webhook subscriptions

The full OpenAPI specification is available and powers the auto-generated endpoint pages in this documentation. You can also download it for use with tools like Postman or code generators.

Getting Started

Endpoints

API Overview

Base URL

Request Format

Example Request

Response Format

Authentication Methods

API Sections

Authentication

Errors & Status Codes

Rate Limiting

Endpoint Reference

Key Endpoint Groups

​Base URL

​Request Format

​Example Request

​Response Format

​Authentication Methods

​API Sections

Authentication

Errors & Status Codes

Rate Limiting

Endpoint Reference

​Key Endpoint Groups

Base URL

Request Format

Example Request

Response Format

Authentication Methods

API Sections

Key Endpoint Groups