# Changelog

What changed in the RedSwitches API, newest first.

## 2026-11-16

- **New address**: the API is at `https://api.redswitches.com/v1` and these docs at `https://api.redswitches.com/docs/`. The old address, `https://dedicated.redswitches.com/api/v1`, still answers during beta. The SDKs, `rxctl`, the MCP server and the Terraform provider use the new address by default.
- **`cap_reached`** details now carry `limit` (a number, or an amount for money limits) and `window` (`day`, `30_days` or `open`).
- **Cooling-off**: ordering opens 24 hours after it was turned on and after a new ordering key. A limit raised by RedSwitches no longer pauses ordering.
- **One-time credentials**: while a switch is off the read answers `503` and keeps the password; a reinstall or rescue whose password could not be kept is `done` with reason `password_unavailable`.

## 2026-11-15: Beta 2

- **Faster reads**: the cacheable reads may be served from a copy at most about a minute old, with an `X-Cache: hit|miss` header.
- **Sliding rate-limit window**: same limits and headers, no burst at the turn of the minute.
- **Field-level error details**: `invalid_body` answers name the field in `details.field` and the rule in `details.reason`, and the message says it too.
- **`Retry-After`** on every error that asks you to wait (`in_progress`, `cooling_off`), not only on `429`.
- **`413 body_too_large`** for a body over 16 KB; `405` answers list the path's methods in `Allow`.
- **Dry run**: `paid_from_credit` is now an amount, the same shape as in the order answer.
- **Traffic since you took over a server**: `basis: "since_ownership"` where the period started before you held the server.
- **Reverse DNS on every server**: some changes, and every clearing of a name (`hostname` `""`), are carried out as actions of kind `rdns`. The list shows `action_id` on every item. See [Reverse DNS](rdns.md).
- **`rescue`** on server detail.
- **Beta: cancellation requests**: `POST`, `GET` and `DELETE /servers/{id}/cancel-request`, with the new `cancel` permission. Always end of billing period. See [Cancellation](cancellation.md).
- **Beta: reinstall**: `GET /servers/{id}/os` (image ids `img_…`) and `POST /servers/{id}/reinstall`, with the new `reinstall` permission. Off unless RedSwitches turns it on. The password is returned only when you ask (`return_password`), once. See [Reinstall](reinstall.md).
- **Beta: rescue mode**: `POST /servers/{id}/rescue` with the new `rescue` permission, and one-time credentials at `GET /actions/{id}/credentials`. Off unless RedSwitches turns it on. See [Rescue](rescue.md).
- **SDKs, CLI, Terraform provider, MCP server**: built, not published yet. See [SDKs](sdks.md).

## 2026-11-15: Beta 1

The first beta, by invitation only.

- Keys made by the account owner in Settings → API, with permissions `read`, `read_billing`, `order`, `manage`, `ssh_keys` and `power`.
- Read: `/auth/verify`, `/account`, `/offers`, `/servers` (with detail and traffic), `/orders`, `/invoices`, `/ssh-keys`.
- Ordering of instant servers paid from account credit, with dry run, `expected_total`, account and key limits, and delivery tracking.
- Rename servers and request reverse DNS.
- Add and remove saved SSH keys.
- Power on, off and reboot, followed through `/actions/{id}`.
- `Idempotency-Key` on every write.