API Overview

Base URL

http://localhost:6877

Configure with ARDEN_HOST and ARDEN_PORT.

Authentication

All endpoints except /health require a Bearer token:

curl http://localhost:6877/session \
  -H "Authorization: Bearer YOUR_API_KEY"

See Authentication for details.

Response format

All endpoints return JSON. The event stream (GET /chat/events/{session_id}) uses Server-Sent Events (SSE).

Endpoints

Group	Endpoints	Description
Chat	`GET /chat/events/{session_id}`, `POST /chat/message`, `POST /chat/background`, `POST /cancel`	SSE stream, messaging, background mode
Sessions	`/session`, `/sessions`	Session management
Areas	`/areas`, `/asks`	Areas, outcomes, standing agents, and requests
Facts and Wiki	`/admin/facts`, `/admin/wiki/pages`	Fact reads and pins; versioned managed wiki pages
Automations	`/automations`, `/loops`	Scheduled tasks and in-chat loops
Config	`/config`, `/models`, `/providers`, `/services`, `/directives`	Configuration, providers, models
Health	`GET /health`	Server status (public)

Health check

curl http://localhost:6877/health

{
  "status": "ok",
  "version": "1.0.0rc3",
  "has_providers": true,
  "outbox": {
    "worker_running": true,
    "pending": 0,
    "ready": 0,
    "running": 0,
    "dead": 0
  },
  "config_version": 1,
  "config_loaded_at": "2026-07-30T12:00:00+00:00"
}

Pass a Bearer token to add an auth result:

{
  "auth": true
}

​Base URL

​Authentication

​Response format

​Endpoints

​Health check

Base URL

Authentication

Response format

Endpoints

Health check