# Hetzner Primary IPs API

**Canonical:** https://apis.io/apis/hetzner/hetzner-primary-ips-api/  
**Provider:** Hetzner — https://apis.io/providers/hetzner/  
**Base URL:** https://api.hetzner.cloud/v1  
**Documentation:** https://docs.hetzner.cloud/

Hetzner Primary IPs API is one of 32 APIs that [Hetzner](https://apis.io/providers/hetzner/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Primary IPs. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and a getting-started guide.

Primary IPs help you to create more flexible networking setups. You can assign at most one Primary IP of type `ipv4` and one of type `ipv6` per Server. This Server then uses these IPs. You can only unassign a Primary IP from a Server when it's powered off. This Primary IP can then be assigned to a different powered off Server, or you can keep it around for later use. Primary IPs are bound to a specific Location. You can not assign a Primary IP from one Location to a Server in a different Location. If you need this capability use Floating IPs instead. If your Server's operating system supports cloud-init there is no further configuration needed to make Primary IPs work. Primary IPs of type `ipv4` use a single IPv4 address as their `ip` property. Primary IPs of type `ipv6` use a /64 network such as `fc00::/64` as their `ip` property. Any IP address within that network can be used on your host. Primary IPs are billed on an hourly basis.

## Machine-readable artifacts (3)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/hetzner/refs/heads/main/openapi/hetzner-primary-ips-api-openapi.yml
- **Documentation** — https://docs.hetzner.cloud/
- **GettingStarted** — https://docs.hetzner.cloud/#getting-started

## Other Hetzner APIs (12)

- [Hetzner DNS API](https://apis.io/apis/hetzner/hetzner-dns-api/)
- [Hetzner Actions API](https://apis.io/apis/hetzner/hetzner-actions-api/)
- [Hetzner Certificate Actions API](https://apis.io/apis/hetzner/hetzner-certificate-actions-api/)
- [Hetzner Certificates API](https://apis.io/apis/hetzner/hetzner-certificates-api/)
- [Hetzner Data Centers API](https://apis.io/apis/hetzner/hetzner-data-centers-api/)
- [Hetzner Firewall Actions API](https://apis.io/apis/hetzner/hetzner-firewall-actions-api/)
- [Hetzner Firewalls API](https://apis.io/apis/hetzner/hetzner-firewalls-api/)
- [Hetzner Floating IP Actions API](https://apis.io/apis/hetzner/hetzner-floating-ip-actions-api/)
- [Hetzner Floating IPs API](https://apis.io/apis/hetzner/hetzner-floating-ips-api/)
- [Hetzner Image Actions API](https://apis.io/apis/hetzner/hetzner-image-actions-api/)
- [Hetzner Images API](https://apis.io/apis/hetzner/hetzner-images-api/)
- [Hetzner ISOs API](https://apis.io/apis/hetzner/hetzner-isos-api/)

## Tags

Primary IPs

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/hetzner/hetzner-primary-ips-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/hetzner/.