RedSwitches API Private beta Reference
Menu

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.
  • 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.
  • 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.
  • 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.
  • SDKs, CLI, Terraform provider, MCP server: built, not published yet. See SDKs.

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.