API Reference

The Orga AI REST API provides direct HTTP access to real-time session infrastructure. These endpoints power the SDKs and can be used for custom integrations, debugging, or building language-specific clients.

Base URL

All endpoints are available at:


https://api.orga-ai.com/v1

All endpoints use HTTPS and communicate using standard JSON request and response bodies.

Endpoints

Client secrets – Exchange your long-lived API key for short-lived ephemeral tokens that authenticate client sessions.
ICE servers – Retrieve STUN/TURN server configuration required for WebRTC connectivity.
WebRTC connection – Initialize a real-time session by exchanging SDP offers and answers.

Authentication flow

Your server calls /client-secrets with your API key to obtain an ephemeral token.
Your server calls /ice-config with the ephemeral token to retrieve ICE server configuration.
Your client calls /calls with the ephemeral token to establish the WebRTC session.

Note: The SDKs abstract these calls into a single initialization flow. Use these endpoints directly only when building custom integrations or debugging.