---
agentTools:
  siteIndex: https://techdocs.akamai.com/llms.txt
  projectIndex: https://techdocs.akamai.com/linode-api/llms.txt
---

# May 13, 2025 — Linode Interfaces and firewall templates (BETA)

**Update:** Linode interfaces and firewall templates is now Generally Available (GA).

Linode Interfaces offer an alternative to the existing Configuration Profile Interfaces for Linode networking. Both interface types support the creation of Public, VPC and VLAN network interfaces, but they differ in the following ways:

* **Interface management endpoints.** Configuration Profile interfaces are managed using the **Interfaces** endpoints, while Linode interfaces are managed using the new **Linode Interfaces** endpoints.
* **Power settings** Linode Interfaces can only be created, deleted, or updated when the Linode is powered off. This ensures a clear and reliable association between the Linode and its network interface settings. In contrast, Configuration Profile Interfaces do not require the Linode to be powered off to make changes; however, any changes will only take effect after the Linode is rebooted.
* **Cloud Firewall integration.** Linode Interfaces allow you to assign a Cloud Firewall directly to the interface. Firewall templates are available for both VPC and public interfaces, and include pre-configured protection rules. For Configuration Profile Interfaces, Cloud Firewalls are assigned at the Linode level, and the same firewall rules apply to all non-VLAN interfaces in the profile.
* **Support for Linodes and LKE.** Linode interfaces are supported on standard Linodes, but not on Linodes within an LKE cluster. If you're using LKE Cluster Linodes, please continue using Configuration Profile interfaces for your setup.
* **Support for private IPs.** Linode interfaces do not support private IPs. If your Linode requires a private IP, please continue using Configuration Profile interfaces for your setup.

# Linode Instances

## Added

**Linode Interfaces.** Added new endpoints for configuring and getting information for Linode interfaces. New operations and responses:

* **List Linode interfaces.** [GET /linode/instances/{linodeId}/interfaces](https://techdocs.akamai.com/linode-api/reference/get-linode-interfaces)
* **Add a Linode interface.** [POST /linode/instances/{linodeId}/interfaces](https://techdocs.akamai.com/linode-api/reference/post-linode-interface)
* **List Linode interface settings.** [GET /linode/instances/{linodeId}/interfaces/settings](https://techdocs.akamai.com/linode-api/reference/get-linode-interface-settings)
* **Update Linode interface settings.** [PUT /linode/instances/{linodeId}/interfaces/settings](https://techdocs.akamai.com/linode-api/reference/put-linode-interface-settings)
* **Get a Linode interface.** [GET /linode/instances/{linodeId}/interfaces/{InterfacesId}](https://techdocs.akamai.com/linode-api/reference/get-linode-interface)
* **Update a Linode interface.** [PUT /linode/instances/{linodeId}/interfaces/{interfacesId}](https://techdocs.akamai.com/linode-api/reference/put-linode-interface)
* **Delete a Linode interface.** [DELETE /linode/instances/{linodeId}/interfaces/{interfacesId}](https://techdocs.akamai.com/linode-api/reference/delete-linode-interface)
* **List Linode interface firewalls.** [GET /linode/instances/{linodeId}/interfaces/{id}/firewalls](https://techdocs.akamai.com/linode-api/reference/get-linode-interface-firewalls)
* **Upgrade to Linode interfaces.** [POST /linode/instances/{linodeId}/upgrade-interfaces](https://techdocs.akamai.com/linode-api/reference/post-upgrade-linode-interfaces)
  > ❗️ This upgrade is an irreversible operation
  >
  > Once a Linode has been upgraded to use Linode interfaces, legacy configuration profile interfaces can't be used. This means that the Linode can no longer be used with Linode products that could be using private IPs (e.g., NodeBalancer). You can use `dry_run` to preview the upgrade.

## Changed

**Linode Instances.** Endpoint updates and additional information related to Linode interfaces have been added to the following APIs:

* **Create a Linode.** [POST /linode/instances](https://techdocs.akamai.com/linode-api/reference/post-linode-instance)
  * Added the `interface_generation` field. This field lets you select one interface type for new Linodes when both legacy configuration profile interfaces and Linode interfaces options are available on your account.
    > 🚧
    >
    > If the `interface_generation` option is set to `linode`, and an interface is created, or the legacy configuration profile interfaces are upgraded, the Linode can't use `legacy_config` interfaces again.
  * Linode interface objects for VPC, VLAN and public have been added to the  `interfaces` field.
* **List Linodes.** [GET linode/instances](https://techdocs.akamai.com/linode-api/reference/get-linode-instances) and **Get a Linode.** [GET linode/instances/{linodeId}](https://techdocs.akamai.com/linode-api/reference/get-linode-instance)
  * Added the `interface_generation` field to the response. This value indicates if the Linode is configured to use `linode` interfaces or `legacy_config` interfaces.
* **Boot a Linode.** [POST linode/instances/{linodeId}/boot](https://techdocs.akamai.com/linode-api/reference/post-boot-linode-instance)
  * If the Linode is using Linode interfaces, where `interface_generation` is set as `linode`, an error is returned if the Linode has to boot without any interface defined.
* **Reboot a Linode.** [POST linode/instances/{linodeId}/reboot](https://techdocs.akamai.com/linode-api/reference/post-reboot-linode-instance)
  * If the Linode is using Linode interfaces, where `interface_generation` is set as `linode`, an error is returned if the Linode has to reboot without any interface defined.
* **Boot a Linode into rescue mode.** [POST linode/instances/{linodeId}/rescue](https://techdocs.akamai.com/linode-api/reference/post-rescue-linode-instance)
  * Linodes with legacy configuration interfaces receive a public IP and boot into the recovery Linux distribution. Linodes with Linode interfaces still boot into recovery mode with the recovery Linux distribution, but they retain their original network interfaces and settings from before entering rescue mode.
* **Clone a Linode.** [POST linode/instances/{linodeId}/clone](https://techdocs.akamai.com/linode-api/reference/post-clone-linode-instance)
  * For Linodes using Linode interfaces, the clone needs to be located in a region that supports Linode interfaces (see [GET a region](https://techdocs.akamai.com/linode-api/reference/get-region)).
  * The [account settings](https://techdocs.akamai.com/linode-api/reference/get-account-settings) needs to allow creation of Linodes with Linode interfaces.
* **Initiate a DC migration/pending host migration.** [POST linode/instances/{linodeId}/migrate](https://techdocs.akamai.com/linode-api/reference/post-migrate-linode-instance)
  * If the Linode is using Linode interfaces, the destination region needs to also support Linode interfaces.
  * After migrating to a different data center, Linode public interfaces retain the same number of IP addresses, but the IP addresses themselves are changed.
* **Rebuild a Linode.** [POST linode/instances/{linodeId}/rebuild](https://techdocs.akamai.com/linode-api/reference/post-rebuild-linode-instance)
  * Linode interfaces are not changed during a rebuild.

**Configurations.** Endpoint updates and additional information related to Linode interfaces have been added to the following APIs:

* **List configuration profiles.** [GET linode/instances/{linodeId}/configs](https://techdocs.akamai.com/linode-api/reference/get-linode-configs)
  * In the response, `null` is returned for `interfaces` and `network` for Linode interfaces.
* **Get a configuration profile.** [GET linode/instances/{linodeId}/configs/{id}](https://techdocs.akamai.com/linode-api/reference/get-linode-config)
  * In the response, `null` is returned for `interfaces` and `network` for Linode interfaces.
* **Create a configuration profile.** [POST linode/instances/{id}/config/{linodeId}/interfaces](https://techdocs.akamai.com/linode-api/reference/post-add-linode-config)
  * This API is for legacy configuration profile interfaces only, and not Linode interfaces.
* **Update a configuration profile.** [PUT linode/instances/{linodeId}/configs/{configId}](https://techdocs.akamai.com/linode-api/reference/put-linode-config)
  * In the request, `interfaces` and `network` can't be updated for Linode interfaces.
  * In the response, `null` is returned for `interfaces` and `network` for Linode interfaces.

**IP addresses.** Endpoint updates and additional information related to Linode interfaces have been added to the following APIs:

* **Get a Linode's IP address.** [GET linode/instances/{linodeId}/ips](https://techdocs.akamai.com/linode-api/reference/get-linode-ip)
  * If the IP is assigned to a Linode interface, the `interface_id` is included in the response.  For legacy config profile interfaces, the value is `null`.
* **Delete an IPv4 address.** [DELETE linode/instances/{linodeId}/ips/{address}](https://techdocs.akamai.com/linode-api/reference/delete-linode-ip)
  * This operation can't be used to delete an IP assigned to a Linode interface, use the [update the Linode interface](https://techdocs.akamai.com/linode-api/reference/put-linode-interface) operation instead.

# Networking - Firewalls

## Added

**Firewall templates.** New endpoints to list available firewall templates or to get a specific firewall template type. Firewall templates can be used with Linode VPC and public interfaces. Firewall templates come with some protection rules already configured. New operations and responses:

* **List firewall templates.** [GET /networking/firewalls/templates](https://techdocs.akamai.com/linode-api/reference/get-firewall-templates)
* **Get a firewall template.** [GET /networking/firewalls/templates/{slug}](https://techdocs.akamai.com/linode-api/reference/get-firewall-template)

**Firewall settings.** Added new endpoints to get or update the default firewalls for Linodes, Linode interfaces, and NodeBalancers.

* **Get default firewalls.**[GET networking/firewalls/settings](https://techdocs.akamai.com/linode-api/reference/get-firewall-settings)
* **Update default firewalls.** [PUT networking/firewalls/settings](https://techdocs.akamai.com/linode-api/reference/put-firewall-settings)

## Changed

* **Create a firewall.** [POST /networking/firewalls](https://techdocs.akamai.com/linode-api/reference/post-firewalls)
  * Added Linode `interfaces` to the `devices` object. For Linodes using Linode interfaces, firewalls need to be assigned to `interfaces` and not `linodes`.
* **Update a firewall.** [PUT networking/firewalls/{firewallId}](https://techdocs.akamai.com/linode-api/reference/put-firewall)
  * An assigned default firewall can't be disabled.
* **Delete a firewall device.** [DELETE networking/firewalls/{firewallId}](https://techdocs.akamai.com/linode-api/reference/delete-firewall)
  * An assigned default firewall can't be deleted.
* **List firewall devices.** [GET networking/firewalls/{firewallId}/devices](https://techdocs.akamai.com/linode-api/reference/get-firewall-devices)
  * Added `interface` to the `entity` object `type`.
* **Create a firewall device.** [POST networking/firewalls/{firewallId}/devices](https://techdocs.akamai.com/linode-api/reference/post-firewall-device)
  * Added `interface` to the list of supported devices.
    * `linode`.  Is not allowed for Linodes using Linode interfaces.
    * `interface`. Is not allowed for legacy config interfaces.
* **Get a firewall device.** [GET networking/firewalls/{firewallId}/devices/{deviceId}](https://techdocs.akamai.com/linode-api/reference/get-firewall-device)
  * Added `interface` to the `entity` object `type`.

# Networking - IPs

## Changed

* **Allocate an IP address.** [POST networking/ips](https://techdocs.akamai.com/linode-api/reference/post-allocate-ip)
  * This API can't be used for Linodes with Linode interfaces. To allocate an IP for a Linode with Linode interfaces, use the [Add a Linode interface](https://techdocs.akamai.com/linode-api/reference/post-linode-interface) operation and set the public IPv4 address to `auto`.
  * Added `interface_id` response field.  An `interface_id` is returned if the IP address belongs to a Linode interface. This value is `null` if a Linode interface is not assigned or if the IP is assigned to a legacy configuration profile interface.
* **List IP addresses** [GET networking/ips](https://techdocs.akamai.com/linode-api/reference/get-ips)
  * This API now returns public IP addresses for both Linode interfaces and Linodes.
  * Added the Linode `interface_id` field. An `interface_id` is returned if the IP address belongs to a Linode interface. This value is `null` if a Linode interface is not assigned or if the IP is assigned to a legacy configuration profile interface.
* **Get an IP address.** [GET networking/ips/{address}](https://techdocs.akamai.com/linode-api/reference/get-ip)
  * Added the Linode `interface_id` field. An `interface_id` is returned if the IP address belongs to a Linode interface. This value is `null` if a Linode interface is not assigned or if the IP is assigned to a legacy configuration profile interface.
* **Assign IP addresses.** [POST networking/ips/assign](https://techdocs.akamai.com/linode-api/reference/post-assign-ips)
  * For Linode interfaces, the Linode needs to have a public interface and the address it receives can't be a private IPv4 address.
* **Assign IPv4s to Linodes.** [POST networking/ipv4/assign](https://techdocs.akamai.com/linode-api/reference/post-assign-ipv4s)
  * For Linode interfaces, the Linode needs to have a public interface and the address it receives can't be a private IPv4 address.
* **Share IP addresses.** [POST networking/ips/share](https://techdocs.akamai.com/linode-api/reference/post-share-ips)
  * A public IPv4 address can't be shared if it's configured for a 1:1 NAT on a `vpc`-purpose configuration profile interface or on a VPC Linode interface.
* **Configure IPv4 sharing.** [POST networking/ipv4/share](https://techdocs.akamai.com/linode-api/reference/post-share-ipv4s)
  * A public IPv4 address can't be shared if it's configured for a 1:1 NAT on a `vpc`-purpose configuration profile interface or on a VPC Linode interface.

# Networking - VLANs

## Changed

* **List VLANs.** [GET /networking/vlans](https://techdocs.akamai.com/linode-api/reference/get-vlans)
  * This endpoint now lists VLANs interfaces from both legacy configuration profiles and Linode interfaces.

# VPCs

## Changed

* **List VPCs.** [GET /vpcs](https://techdocs.akamai.com/linode-api/reference/get-vpcs) and **Get a VPC.** [GET /vpcs/{vpcId}](https://techdocs.akamai.com/linode-api/reference/get-vpc)
  * Added `config_id`, the globally general entity ID for the Linode configuration profile where the VPC is included. If this is a VPC Linode interface, the value is `null`.
* **List VPC subnets.** [GET /vpcs/{vpcId}/subnets](https://techdocs.akamai.com/linode-api/reference/get-vpc-subnets) and **Get a VPC subnet.** [GET /vpcs/{vpcId}/subnets/{vpcSubnetId}](https://techdocs.akamai.com/linode-api/reference/get-vpc-subnet)
  * Added `config_id`, the globally general entity ID for the Linode configuration profile where the VPC is included. If this is a VPC Linode interface, the value is `null`.
* **List VPC IP addresses.**[GET /vpcs/ips ](https://techdocs.akamai.com/linode-api/reference/get-vpcs-ips) and **List a VPC's IP addresses.** [GET /vpcs/{vpcId}/ips](https://techdocs.akamai.com/linode-api/reference/get-vpc-ips)
  * If `config_id` is `null`, it indicates that this is a VPC Linode interface.

# Accounts

## Changed

**Accounts settings.** You can now view and update the interfaces to use on new Linodes. New operations and responses:

* **Get account settings.** [GET /account/settings](https://techdocs.akamai.com/linode-api/reference/get-account-settings)
  * Added the `interfaces_for_new_linodes` field to the response. This value indicates if new Linodes created on the account can use legacy configuration interfaces.
* **Update account settings.** [PUT /account/settings](https://techdocs.akamai.com/linode-api/reference/put-account-settings)
  * Added the `interfaces_for_new_linodes` field to the request and response. This value indicates if new Linodes created on the account can use legacy configuration interfaces.

**Service transfers.** Added "VPC interface" and "/32" IPv6 range to the list of conditions that prevent service transfers.

* **Request a service transfer.** [POST /account/service-transfers](https://techdocs.akamai.com/linode-api/reference/post-service-transfer)

# Regions

## Changed

* **List regions.** [GET /regions](https://techdocs.akamai.com/linode-api/reference/get-regions)
  * Added `Linode Interfaces` to the list of capabilities that may be available in a region.