Skip to main content
This section documents the public chat API flow for external builders.
  1. Use your user bearer token (ara_api_* or dashboard JWT)
  2. Ensure your personal cloud session is active
  3. Call POST /v1/chat

​
Base URL

https://api.ara.so

​
Core invoke endpoint

POST /v1/chat Auth header: Authorization: Bearer ara_api_...

​
Runtime behavior

  • Routes into the caller’s active personal session runtime.
  • Returns 503 if the user has no active personal session.
  • Returns a single JSON assistant response (streaming is disabled).

​
Deprecated endpoints

Legacy agent-management and explicit-agent chat endpoints are deprecated and intentionally removed from public docs.

​
OpenAPI source