Previous Versions (Legacy)
Legacy surfaces
New integrations must use the v1 API Reference and v1 Webhooks.
The pages under Previous Versions document older API generations that remain available for existing callers. They are frozen: new features ship only on v1. Prefer the Migration Guide: v0 → v1 if you are upgrading.
| Surface | Base URL | Status |
|---|---|---|
| API v0 Overview | https://api.ro.am/v0 | Frozen Alpha — supported, no new features |
| Webhooks v0 Overview | https://api.ro.am/v0 | Frozen Alpha — some events (e.g. recording:saved) have no v1 successor yet |
A few v1 routes remain registered only for existing callers and are labeled (Legacy) in the API Reference sidebar next to their modern replacements:
| Legacy route | Prefer instead |
|---|---|
chat.sendMessage | chat.post |
groups.list | group.list |
recording.list | meeting.list / meeting.info |
What to use instead
| You need… | Use (v1) |
|---|---|
| Chat, groups, users, meetings | API Reference — https://api.ro.am/v1 |
| Real-time events | Webhooks — chat.message, meeting.ended, … |
| User provisioning | SCIM 2.0 |
| On-Air events | On-Air API |
| Version pin / envelope changes | API Versioning |
v0 routes continue to work for existing integrations. Do not start new work against them unless a migration note explicitly requires it (for example raw recording media download via recording.list).