ARIA API Reference

Returns all active API keys for the authenticated user. Raw key values are never returned after creation.

{"keys": [{"id": 1, "name": "My App", "prefix": "aria_abc1", "scopes": "chat:write memory:read", "is_active": true, "created_at": "2026-03-01T12:00:00"}]}

Generates a new API key. The full key is returned once — copy it immediately. Maximum 10 active keys per account.

{"ok": true, "key": "aria_abc123...", "id": 1, "prefix": "aria_abc1", "name": "My App", "note": "Store this key securely — it will not be shown again."}

Permanently revokes the key. The key stops working immediately.

{"ok": true, "revoked": 1}

Returns platform status. Use this to confirm the API is reachable before making authenticated requests.

{"status": "ok", "version": "1.0.0", "docs": "/api/v1/openapi.json"}

Send a message and receive ARIA's full response. Processes through the full agent pipeline — memory recall, specialist routing, tool execution. Scope required: chat:write

POST /api/v1/chat
Authorization: Bearer aria_your_key_here
Content-Type: application/json

{
  "message": "Write a subject line for our Black Friday campaign",
  "conversation_id": "550e8400-e29b-41d4-a716-446655440000"
}

{
  "reply": "Here are five subject lines optimised for open rate...",
  "conversation_id": "550e8400-e29b-41d4-a716-446655440000",
  "model_used": "claude-sonnet-4-6"
}

Full-text search across ARIA's persistent memory for the API key owner's account. Returns ranked results. Scope required: memory:read

{
  "results": [
    {"key": "client_abc_notes", "value": "Prefers email on Tuesdays...", "score": 0.94},
    {"key": "product_pricing", "value": "Pro plan at $49/month...", "score": 0.81}
  ],
  "count": 2
}

Returns the full list of specialist agents available on this ARIA instance. Use agent names to direct conversations to specific areas of expertise. Scope required: agents:read

{
  "agents": [
    {"name": "Marketing Strategist", "domain": "marketing", "description": "Campaign strategy, positioning, messaging"},
    {"name": "Financial Analyst",    "domain": "finance",    "description": "Forecasting, modelling, reporting"},
    ...
  ],
  "count": 212
}

Returns a session cookie on success. Rate-limited to 10 requests/minute per IP.

First registered user becomes the owner. Subsequent registrations create standard users.

Clears session cookie. Redirects to /login.

Primary chat endpoint used by the ARIA web app. Returns a Server-Sent Events stream. Each event is a JSON object on a data: line.

data: {"type": "status",  "text": "Routing to Financial Analyst..."}
data: {"type": "delta",   "text": "Here is your Q1 forecast:\n\n"}
data: {"type": "delta",   "text": "Revenue: $142,000..."}
data: {"type": "done",    "session_id": "550e8400-...", "tokens": 312}

Returns the 50 most recent conversations for the authenticated user, sorted by last activity.

Returns the full message history for the specified conversation ID.

Permanently removes the conversation and all its messages.

Returns the current business directive content that ARIA uses to personalise every response.

{"content": "# My Business\nWe sell...", "is_blank": false}

Update ARIA's business context. Accepts either raw markdown or structured fields.

Required by Meta during webhook setup. Verifies hub.verify_token against WHATSAPP_VERIFY_TOKEN env var. Returns hub.challenge on success.

Meta delivers message events here. ARIA routes each message through the full agent pipeline and replies automatically. Returns 200 immediately — processing is asynchronous.

Stripe delivers subscription and payment events here. Signature verification is performed using STRIPE_WEBHOOK_SECRET. Do not call this endpoint directly.

Downloads a full JSON export of your account data — conversations, memory, profile. Rate-limited to 5 requests/minute.

Returns whether your account contributes anonymised patterns to collective intelligence. Default: true (opted in).

{"data_sharing": true}

Permanently erases all data for the authenticated user. Requires password confirmation. The owner account cannot be deleted while users remain on the platform.

Returns platform health, version, counts, and component status. Used by load balancers and uptime monitors.

{
  "status":  "healthy",
  "version": "1.0.0",
  "agents":  212,
  "skills":  18,
  "tools":   191,
  "db":      "ok",
  "llm":     "ok",
  "users":   4
}

Machine-readable OpenAPI spec for the v1 public API. Import into Postman, Insomnia, or any OpenAPI-compatible tool.