Hetzner Cloud

Structured JSON error responses: {error: {code: '...', message: '...'}} with HTTP status codes. 401 for invalid token, 422 for invalid parameters (with field-level details), 429 for rate limit (generous: 3600 requests/hour by default). Action-based operations return an Action object with status (running/success/error); agents must poll GET /v1/actions/{id} for completion. Hetzner Cloud SLA: 99.9% availability for VMs. Status at status.hetzner.com.

REST API at api.hetzner.cloud/v1. Resources: servers, server_types, images, volumes, load_balancers, networks, firewalls, floating_ips, ssh_keys, datacenters. POST /v1/servers creates a server with type, image, location, user_data (cloud-init), ssh_keys. GET /v1/servers lists all servers with status and IP. Actions API tracks long-running operations (server creation, volume attachment). Consistent JSON response envelope: {result: {...}} or {results: [...]} with pagination. Filtering via query params (name, label_selector).

Hetzner Cloud provides VMs (cloud servers), load balancers, block volumes, object storage (S3-compatible), networks, firewalls, and snapshots — all manageable via a well-designed REST API. For agents, the API enables full infrastructure lifecycle management: provisioning servers, managing networks, creating/restoring snapshots, and configuring load balancers. Pricing is notably competitive (often 3-5× cheaper than major cloud providers for equivalent compute), making it popular for cost-aware agent infrastructure workflows. Clean API design with consistent patterns, good documentation, and generous rate limits. Confidence is docs-derived.

Bearer token auth via Authorization: Bearer header. Tokens are per-project; each Hetzner project has its own API token namespace. Tokens created via Hetzner Cloud Console. Read-only vs. read-write token permissions configurable. No OAuth2; API token is the single auth mechanism. Token rotation via Console. Multiple tokens per project supported for least-privilege agent access.

docs.hetzner.cloud provides a comprehensive API reference (OpenAPI spec available), concept guides (servers, networks, volumes, load balancers), and examples. The documentation is well-organized and complete. Getting started requires a Hetzner account (free trial credits available). Community support via Hetzner Community Forum. Official SDKs available for Python (hcloud), Go, and others via community.