# Previous Versions (Legacy)

:::warning Legacy surfaces
**New integrations must use the [v1 API Reference](/docs/api/api) and [v1 Webhooks](/docs/webhooks/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](/docs/guides/migration-v0-to-v1) if you are upgrading.
:::

| Surface | Base URL | Status |
|---------|----------|--------|
| [API v0 Overview](/docs/chat-api/api-v-0-overview) | `https://api.ro.am/v0` | Frozen Alpha — supported, no new features |
| [Webhooks v0 Overview](/docs/webhooks-v0-dev/webhooks-v-0-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](/docs/api/api) sidebar next to their modern replacements:

| Legacy route | Prefer instead |
|--------------|----------------|
| `chat.sendMessage` | [`chat.post`](/docs/api/chat-post) |
| `groups.list` | [`group.list`](/docs/api/group-list) |
| `recording.list` | [`meeting.list`](/docs/api/meeting-list) / [`meeting.info`](/docs/api/meeting-info) |

## What to use instead

| You need… | Use (v1) |
|-----------|----------|
| Chat, groups, users, meetings | [API Reference](/docs/api/api) — `https://api.ro.am/v1` |
| Real-time events | [Webhooks](/docs/webhooks/webhooks) — `chat.message`, `meeting.ended`, … |
| User provisioning | [SCIM 2.0](/docs/scim/roam-hq-scim-2-0-api) |
| On-Air events | [On-Air API](/docs/onair-api/on-air-api) |
| Version pin / envelope changes | [API Versioning](/docs/guides/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`).