API reference

Placeholder API reference for Ceili endpoints and payloads.

API reference

This page is a placeholder for the Ceili API documentation. The API will eventually include authentication, messaging, users, channels, and moderation endpoints.

Base URL

https://your-ceili-domain.example/api

Authentication

Most authenticated endpoints expect a bearer token or session cookie.

Authorization: Bearer <token>

Core endpoints

Health check

GET /api/v1/health

Response:

{
  "status": "ok",
  "version": "0.1.0",
  "timestamp": "2026-08-13T00:00:00Z"
}

User session

POST /api/v1/auth/login

Channels

GET /api/v1/channels
POST /api/v1/channels

Messages

GET /api/v1/channels/{channelId}/messages
POST /api/v1/channels/{channelId}/messages

Presence

GET /api/v1/presence

WebSocket events

Ceili may also support live updates through a websocket channel for presence and message streaming.

wss://your-ceili-domain.example/ws

The exact contract will be finalized as the public API matures.