Introduction - Arct Cloud

The Arct Cloud API manages servers, SSH keys, invoices and the catalog. Use the Python and TypeScript SDKs in applications or the Arct CLI in your terminal.

export ARCT_TOKEN="arct_your_token_here"

curl https://api.arct.cloud/v1/account \
  -H "Authorization: Bearer $ARCT_TOKEN"

403 api_access_disabled means the API isn’t enabled for your account yet; contact support.

Base URL

https://api.arct.cloud/v1

HTTPS only. JSON request and response bodies.

Before You Start

Create an API token; see Authentication.
POST /servers and resizes charge a saved card; see Creating Servers.

What You Can Do

Area	`read` token (`GET`)	`read_write` token adds
Account	`/account`
Catalog	`/locations`, `/plans`, `/images`
Servers	`/servers`, `/servers/{server_id}`, `/servers/{server_id}/resize-options`	`POST /servers`, `PATCH` and `DELETE /servers/{server_id}`, start, stop, restart, reinstall, resize, cancel scheduled deletion
SSH Keys	`/ssh-keys`, `/ssh-keys/{key_id}`	`POST /ssh-keys`, `DELETE /ssh-keys/{key_id}`
Invoices	`/invoices`, `/invoices/{invoice_id}`

Conventions

Topic	Rule
IDs	UUIDs. Locations use `code` (any case in, lowercase out); plans use `slug`.
Money	USD.
Timestamps	ISO 8601, UTC.
Lists	Paginated with `page` and `per_page`.
Errors	One envelope with a stable `code`.
Limits	Rate limits per token; writes also per account.

OpenAPI Specification

Fetch it without a token.

curl https://api.arct.cloud/v1/openapi.json

Not in the API

Dashboard only: password reset, paying invoices, cards and the default card, backup/snapshot management, API tokens, the VNC console, crypto payments. The API supports scheduled deletion and cancellation, and server creation can enable automatic backups. No webhooks; poll GET /servers/{server_id}.