v2.19.0

Primary IPs assignee_type behavior change

In the create Primary IP call, the assignee_type argument is now only send when the assignee_id argument is set. The assignee_type argument will stop defaulting to server in the near future, consider explicitly setting this argument when needed.

As of 1 August 2026, the behavior of the Primary IP assignee_type property will change, and will return unassigned when the Primary IP is not assigned (when assignee_id is null). The goal is to eventually assign Primary IPs to other resource types, not only to server.

See the changelog for more details.

In addition, the Primary IP request body assignee_type property of the operation POST /v1/primary_ips is now optional. Primary IPs created without assignee_type return server until 1 August 2026, after this date, its value will be unassigned.

See the changelog for more details.

Features

• primary-ip: assignee_type behavior changed when creating a primary ip (#647)

v2.18.0

Available and recommended Server Types have been moved

Datacenter.server_types has been deprecated in favor of the new ServerType.locations[].available and ServerType.locations[].recommended properties.

See the changelog for more details.

Features

• datacenter, server_type: move available and recommended to server_type (#645)

v2.17.1

Bug Fixes

• missing __api_properties__ on LoadBalancerService (#639)

v2.17.0

Features

• parse nested load balancer label_selector targets (#633)

v2.16.0

Storage Boxes support is now generally available

The experimental phase for Storage Boxes is over, and Storage Boxes support is now generally available.

Features

• servers: allow setting user_data for rebuild (#627)
• Storage Box support no longer experimental (#626)

v2.15.0

Features

• add name to Storage Box Subaccount (#621)

v2.14.0

Features

• retry requests when the api returns a timeout error (#617)

v2.13.0

Phasing out datacenters in Primary IPs and Servers

We added a new location property to the request body and response of Servers and Primary IPs. The same data was previously present under datacenter.location.

We deprecated the datacenter property in the request body and response of Servers and Primary IPs. The removal will happen after 1 July 2026.

See our changelog for more details.

Features

• add per primary ip actions list operations (#608)
• deprecate datacenter in primary ips and servers (#609)

v2.12.0

Storage Box API Experimental

This release adds support for the Storage Box API.

The Storage Box integration will be introduced as an experimental feature. This experimental phase is expected to last at least until 12 January 2026. During this period, upcoming minor releases of the project may include breaking changes to features related to Storage Boxes.

This release includes all changes from the recent Storage Box API changelog entry.

Examples

response = client.storage_boxes.create(
    name="string",
    location=Location(name="fsn1"),
    storage_box_type=StorageBoxType(name="bx11"),
    labels={
        "environment": "prod",
        "example.com/my": "label",
        "just-a-key": "",
    },
    password="my-password",
    access_settings=StorageBoxAccessSettings(
        reachable_externally=False,
        samba_enabled=False,
        ssh_enabled=False,
        webdav_enabled=False,
        zfs_enabled=False,
    ),
    ssh_keys=[SSHKey(public_key="ssh-rsa AAAjjk76kgf...Xt")],
)

response.action.wait_until_finished()

storage_box = response.storage_box

Features

• add update rrset records action to zone client (#597)
• add support for Storage Boxes (#524)

v2.11.1

Bug Fixes

• support reloading sub resource bound models (#590)