API Reference

This section documents the public EfficientAI platform API surface under /api/v1/.

Base URL

  • Self-hosted default: http://localhost:8000
  • Runtime override: set DOCS_API_URL while generating docs.

Authentication

Most endpoints accept either:

  • Authorization: Bearer <token>
  • X-API-Key: <api-key>

Optional workspace scoping header:

  • X-Workspace-Id: <workspace-uuid>

See Authentication Guide.

Versioning

All documented REST endpoints are versioned under /api/v1/.

Endpoint groups

Use the left sidebar to browse generated operation pages by functional area:

  • Agents, Personas, Scenarios
  • Evaluators, Suites, Metrics, Results
  • Integrations, Voice Bundles, AI Providers
  • Observability, Call Imports, Workspaces

See Error Model for error envelope conventions.

Community & contact

  1. Found a bug or have a feature request? Open a GitHub issue.
  2. Join our Discord for faster replies!