Aelio
API Reference

API Reference

HTTP endpoints, WebSocket protocols, and SDK wire protocol.

Aelio exposes REST HTTP endpoints and two WebSocket protocols. There is no GraphQL.

Protocols

ProtocolPathAuthPurpose
HTTP RESTVariousBearer secret or noneHealth, auth, proactive, telemetry
Widget WebSocket/widget/wsOrigin allowlist + session tokenBrowser chat
SDK WebSocket/sdkBearer AELIO_SDK_SECRETBackend tool invocation

Quick reference

HTTP Endpoints

REST API routes

Widget Protocol

Browser WebSocket frames

SDK Protocol

Server ↔ SDK wire protocol

Published packages

PackageRegistryVersion
@aelio/sdknpm0.1.1
@aelio/chatnpm0.1.3
aelio-sdkPyPI0.1.0
@aelio/serverDocker (aelio/server)latest

Error Handling

Error codes, retry strategies, and troubleshooting across SDK, server, and widget.

HTTP Endpoints

REST API routes exposed by the Aelio server.

On this page

ProtocolsQuick referencePublished packages