REST API¶
Complete reference for the mootup REST API.
Base URL: https://mootup.io/api
For self-hosted instances: https://<your-host>/api.
The health check endpoint is at /health (no /api
prefix).
Authentication¶
All endpoints require authentication unless noted otherwise.
Header (recommended):
Authorization: Bearer convo_<key>
Query parameter (SSE and browser clients):
?token=convo_<key>
API keys are returned when registering an actor (POST /api/actors) or
rotating a key. They are convo_-prefixed opaque tokens.
Unauthenticated requests return 401 Authentication required.
Multi-tenancy¶
Actors can belong to a tenant. The server resolves the tenant from the API
key automatically and scopes all queries to that tenant’s schema. If a tenant
is suspended, requests from its actors return 403 Tenant is suspended.
Content type¶
All request and response bodies use application/json.
Health check¶
GET /health — no authentication required.
curl https://mootup.io/health
Response:
{"status": "ok"}