ReferenceREST API
API explorer
Every endpoint and schema in the CosmoRealtime REST API, rendered from the OpenAPI document.
Rendered from the same OpenAPI document the SDKs are generated from — the raw spec is also served directly. Requests run against https://platform.askcosmo.ai with a workspace API key as the bearer token, so a call you compose here is runnable as-is. For the semantics the schema can't carry, see Session start and the wire protocol.
Endpoints
| Method | Path | Summary |
|---|---|---|
| POST | /api/v1/external/realtime/session/start | Start a realtime session |
| POST | /api/v1/external/realtime/session/{session_id}/dial | Dial out from a session |
| GET | /api/v1/external/realtime/verify | Verify a realtime credential |
| GET | /api/v1/external/sessions | List sessions |
| GET | /api/v1/external/sessions/capabilities | Get provider capabilities |
| POST | /api/v1/external/sessions/import | Import a session |
| GET | /api/v1/external/sessions/{session_id} | Get a session |
| DELETE | /api/v1/external/sessions/{session_id} | Delete a session |
| GET | /api/v1/external/sessions/{session_id}/transcript | Get a session transcript |
| GET | /api/v1/external/sessions/{session_id}/usage | Get a session's usage |
| POST | /api/v1/external/auth/token | Mint an end-user token |
| DELETE | /api/v1/external/auth/token/{token_id} | Revoke an end-user token |
Loading the API reference…