This is the official API documentation for the Public Hetzner Cloud. ## Introduction The Hetzner Cloud API operates over HTTPS and uses JSON as its data format. The API is a RESTful API and utilizes
Full LLM thinking from the 4-phase benchmark pipeline.
```json
{
"service_type": "platform",
"base_url": "https://api.hetzner.cloud/v1",
"auth_method": "bearer_token",
"auth_config": {
"header": "Authorization",
"scheme": "Bearer",
"token_source": "Hetzner Cloud Console -> Project -> Security -> API Tokens",
"notes": "Tokens are scoped per project and support read and/or write permissions"
},
"endpoints": [
{
"path": "/servers",
"method": "GET",
"description": "List all servers in the project"
},
{
"path": "/servers",
"method": "POST",
"description": "Create a new server"
},
{
"path": "/servers/{id}",
"method": "GET",
"description": "Get a specific server"
},
{
"path": "/servers/{id}",
"method": "PUT",
"description": "Update a server"
},
{
"path": "/servers/{id}",
"method": "DELETE",
"description": "Delete a server"
},
{
"path": "/servers/{id}/actions/{action}",
"method": "POST",
"description": "Perform actions (poweron, poweroff, reboot, reset, reset_password, enable_backup, disable_backup, attach_iso, detach_iso, change_type, enable_rescue, disable_rescue, attach_to_network, detach_from_network, change_protection, rebuild, request_console, change_alias_ips, change_dns_ptr)"
},
{
"path": "/images",
"method": "GET",
"description": "List available images (system snapshots, backups)"
},
{
"path": "/floating_ips",
"method": "GET/POST",
"description": "Manage floating IPs"
},
{
"path": "/volumes",
"method": "GET/POST",
"description": "Manage block storage volumes"
},
{
"path": "/networks",
"method": "GET/POST",
"description": "Manage private networks"
},
{
"path": "/load_balancers",
"method": "GET/POST",
"description": "Manage load balancers"
},
{
"path": "/firewalls",
"method": "GET/POST",
"description": "Manage firewalls"
},
{
"path": "/ssh_keys",
"method": "GET/POST",
"description": "Manage SSH keys"
},
{
"path": "/primary_ips",
"method": "GET/POST",
"description": "Manage primary IPv4/IPv6 addresses"
},
{
"path": "/certificates",
"method": "GET/POST",
"description": "Manage TLS certificates"
},
{
"path": "/placement_groups",
"method": "GET/POST",
"description": "Manage placement groups for anti-affinity"
},
{
"path": "/pricing",
"method": "GET",
"description": "List pricing for all server types and resources"
},
{
"path": "/actions",
"method": "GET",
"description": "List all actions across the project"
},
{
"path": "/locations",
"method": "GET",
"description": "List available data center locations (e.g., nbg1, fsn1, hel1, ash, hil, sin)"
},
{
"path": "/datacenters",
"method": "GET",
"description": "List available datacenters"
},
{
"path": "/server_types",
"method": "GET",
"description": "List available server types and specs"
},
{
"path": "/isos",
"method": "GET",
"description": "List available ISOs"
},
{
"path": "/ssh_keys/{id}",
"method": "GET/PUT/DELETE",
"description": "Manage individual SSH key"
}
],
"pricing_model": {
"type": "subscription",
"details": {
"billing": "hourly, capped at monthly price",
"notes": "Pay-as-you-go for cloud resources (servers, volumes, load balancers, floating IPs, etc.). Volume discounts available. No charges while server is off (except for storage of disks, snapshots, primary IPs).",
"free_tier": "No free tier, but competitive pricing starting from ~€3.29/month for CX22 server",
"api_cost": "API access itself is free; you pay for resources provisioned"
}
},
"rate_limits": {
"requests_per_hour": 3600,
"burst": "Unknown",
"notes": "Rate limit headers returned: X-Ratelimit-Limit, X-Ratelimit-Remaining, X-Ratelimit-Reset. Exceeding returns HTTP 429. Default soft limit ~3600 requests/hour per token, adjustable on request."
},
"capabilities": [
"Cloud server provisioning and lifecycle management (x86 and ARM/Ampere)",
"Block storage volumes",
"Floating IPs and Primary IPs",
"Private networking (vSwitch-like networks)",
"Load balancers (L4/L7)",
"Firewalls (stateful, per-server)",
"SSH key management",
"TLS certificate management (uploaded and managed via Let's Encrypt)",
"Placement groups for anti-affinity",
"Server snapshots and backups",
"Rescue mode and console access",
"ISO mounting for custom OS installs",
"Rebuild and server type changes (rescale)",
"DNS PTR (reverse DNS) management",
"IPv4/IPv6 dual-stack",
"Multi-location deployment (Germany, Finland, USA, Singapore)",
"Object storage (3/3 tests passed
| Test | Endpoint | Status | Latency |
|---|---|---|---|
| website_uptime | GET / | 200 | 1109ms |
| robots_txt | GET /robots.txt | 200 | 508ms |
| llms_txt | GET /llms.txt | 200 | 519ms |
{
"overall": 38,
"dimensions": {
"token_efficiency": 4.0,
"first_try_success": 5.0,
"response_parseability": 3.0,
"error_clarity": 3.0,
"doc_quality": 3.0,
"auth_simplicity": 5.0,
"latency": 5.0,
"consistency": 6.0
},
"pricing_normalized": {
"model": "unknown",
"notes": "No pricing data available in provided capability/pricing payload."
},
"issues": [
"No structured capability list or pricing model provided — value prop cannot be summarized concisely.",
"robots.txt and llms.txt endpoints return HTML (same page) rather than actual robots/llm metadata — unclear agent guidance.",
"No visible API, SDK, or structured data surface in checks.",
"Documentation quality cannot be assessed from available data; no getting-started or help docs surfaced.",
"Latency ~1.1s on root, ~500ms on sub-paths — moderate, not agent-fast."
],
"recommendations": [
"Publish a valid /llms.txt and /robots.txt with plain-text agent instructions.",
"Expose a machine-readable capabilities/OpenAPI spec and public pricing endpoint.",
"Provide magic-link or SSO onboarding to reduce signup friction.",
"Add structured docs (getting-started, auth, limits) targetable by agents.",
"Reduce TTFB below 500ms across primary endpoints for agent workflows."
]
}Show your live agent-readiness score on your own site. Free, no auth — it updates as your score changes.
<a href="https://prowl.world/service/hetzner-cloud-api">
<img src="https://prowl.world/badge/hetzner-cloud-api.svg" height="56" alt="Agent-readiness on Prowl">
</a>
See operational metrics, LLM evaluations, agent readiness, and more.
Open in Dashboard