Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Hetzner Images API

Images are blueprints for your VM disks. They can be of different types:### System ImagesDistribution Images maintained by us, e.g. “Ubuntu 20.04”### Snapshot ImagesMaintained by you, for example “Ubuntu 20.04 with my own settings”. These are billed per GB per month.### Backup ImagesDaily Backups of your Server. Will automatically be created for Servers which have backups enabled (`POST /servers/{id}/actions/enable_backup`)Bound to exactly one Server. If you delete the Server, you also delete all backups bound to it. You may convert backup Images to snapshot Images to keep them.These are billed at 20% of your server price for 7 backup slots.### App ImagesPrebuild images with specific software configurations, e.g. “Wordpress”. All app images are created by us.

Hetzner Images API is one of 32 APIs that Hetzner publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Images. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and a getting-started guide.

This API exposes 4 operations across 2 paths. It is described by OpenAPI 3.0.3, at version 1.0.0.

Requests are made against a single base URL, https://api.hetzner.cloud/v1.

4 operations 2 paths 0 schemas 1 DELETE2 GET1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
1.0.0
Base URL
https://api.hetzner.cloud/v1
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

Hetzner Images API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (APIToken). By default, every request must be authenticated.

Paths & Operations 4

Across 2 paths, the API surfaces 4 operations — 1 DELETE, 2 GET, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

Images 4

Images are blueprints for your VM disks. They can be of different types: System Images Distribution Images maintained by us, e.g. “Ubuntu 20.04” Snapshot Images Maintained by you,…

GET
/images
List Images
list_images 10 params → 2004xx5xx
GET
/images/{id}
Get an Image
get_image 1 param → 2004xx5xx
PUT
/images/{id}
Update an Image
update_image 1 param body → 2004xx5xx
DELETE
/images/{id}
Delete an Image
delete_image 1 param → 2044xx5xx

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

hetzner-images-api-openapi.yml Raw ↑

Other APIs Hetzner publishes across the network.

Hetzner DNS API
Hetzner Actions API
Hetzner Certificate Actions API
Hetzner Certificates API
Hetzner Data Centers API
Hetzner Firewall Actions API
Hetzner Firewalls API
Hetzner Floating IP Actions API
Hetzner Floating IPs API
Hetzner Image Actions API
Hetzner ISOs API
Hetzner Load Balancer Actions API