API documentation

The hostd API lets you manage your account programmatically. Base URL: https://api.hostd.cloud/v1.

AuthenticationCopy Anchor Link

Most endpoints require an API key. Create a key in the portal under Settings → API Keys and send it as a Bearer token:

Authorization: Bearer <your-api-key>

curl -H "Authorization: Bearer <your-api-key>" https://api.hostd.cloud/v1/network/ips/

Listing clusters is public and does not require authentication.

A key acts on your behalf and never exceeds your role in a project (including projects shared with you). When you create or edit a key, choose what it can reach:

• Projects — choose projects one by one, with Read (reads only), Write (everything except deleting), or Full (also deletes VMs, the project, and public IPs) access. A new key has no access until you choose.
• Create new projects — allowed separately. The key gets Full access to the projects it creates.
• SSH keys — No access, Read, or Write.
• Expiration — 30 days, 90 days, 1 year, a custom date, or no expiration. We email you 7 days before a key expires.

IP addresses of dedicated servers and VPS are not available with API keys. A key works only with the endpoints in this reference — account settings, billing, support, and API key management are available only in the portal. The same access applies to the MCP server.

LimitsCopy Anchor Link

Requests with an API key are limited per account (all keys share the limit):

• 10 requests per second;
• 90 write requests (POST, PUT, PATCH, DELETE) per minute.

Above the limit the API returns 429 Too Many Requests with a Retry-After header (seconds). Wait that long before retrying.

AI agentsCopy Anchor Link

The MCP server gives AI agents (Cursor, Claude Code) access to the same API.

EndpointsCopy Anchor Link

• Clusters — Public Cloud zones and hourly pricing.
• Projects — projects, account usage, and cluster tasks.
• Virtual machines — create, delete, inventory, OS images, configuration, metrics, power, resize, and notes.
• High availability — enable HA per VM and manage placement rules.
• SSH keys — SSH public keys on your account, used when creating VMs.
• Private networks — free and used addresses in a private network.
• Snapshots — one snapshot per VM.
• Backups — run a VM backup now, restore VM backups, browse the project backup datastore, and download files from a backup.
• Backup jobs — scheduled backup jobs of a project.
• Firewall — the project firewall in one request, and per-VM firewall options and rules.
• Security groups — project security groups and their rules.
• IP sets — project IP sets and their members.
• IP addresses — assigned IP addresses and PTR records (account-wide and per project).