Skip to main content
Integrate with Ara runtime and control-plane features programmatically.

​
Base URL

https://api.ara.so
Most routes require JWT auth. Some proxy/internal routes use service tokens.

​
Authentication

Example authenticated request: 
curl https://api.ara.so/session/status \
  -H "Authorization: Bearer YOUR_TOKEN"

​
Endpoint groups

GroupExample endpoints
Session lifecycle/session/start, /session/status, /session/stop, /session/restart-gateway
Realtime/WebSocket/ws/{session_id}, /session/terminal/{session_id}, /ws/public/{handle}
Files/session/files, /session/files/read, /session/files/write
Skills/session/skills, /session/skills/{name}
Credentials/credentials
Usage/Billing/usage, /billing/*
Integrations/MCP/session/inject, /mcp/*, /composio/*

​
Realtime model

Cloud API authenticates websocket clients, resolves active sessions, then proxies traffic to runtime endpoints inside the sandbox.

​
Typical client sequence

  1. POST /session/start
  2. GET /session/status
  3. Connect websocket (/ws/{session_id})
  4. Perform file/skill calls as needed
  5. POST /session/stop when done

​
Response and errors

Error payloads use standard HTTP status codes with descriptive JSON detail messages.

Sessions

Session lifecycle, gateway restarts, and runtime injection.

Credentials and usage

Provider key handling, credit state, and usage metrics.