---
title: "Save Host Interface L3 Configuration"
method: PUT
path: "/network/interface/{name}/l3"
tags: ["Network"]
---

# Save Host Interface L3 Configuration

`PUT /network/interface/{name}/l3`

Stage a Host IP change; the response carries the pending id and the 60-second confirmation deadline

## Path parameters

- `name` string, required

## Request body

- InternalHandlersNetworkHostInterfaceL3SaveRequest
  - `addresses` InternalHandlersNetworkHostInterfaceL3AddressPayload[]
    - `address` string, required
  - `expectedRevision` integer
  - `ipv6Mode` 'inherit' | 'enabled' | 'disabled'
  - `metric` integer
  - `mtu` integer

## Response `202`

Applied, awaiting confirmation

- GithubComAlchemillahqSylveInternalAPIResponseGithubComAlchemillahqSylveInternalInterfacesServicesNetworkHostInterfaceL3PendingEntry
  - `data` GithubComAlchemillahqSylveInternalInterfacesServicesNetworkHostInterfaceL3PendingEntry
    - `deadline` string
    - `id` string
    - `interface` string
    - `kind` string
    - `phase` string
  - `error` string
  - `message` string
  - `status` string

## Other responses

- `400` — Invalid request
- `409` — Revision, pending or interface conflict
- `500` — Internal Server Error

## Changes

- **2026-10-02** `ed7995769920` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/alchemillahq/apis/sylve-api/changes/network/interface/:name/l3/put.md)

---

[API](https://skmtc.dev/alchemillahq/apis/sylve-api.md) · [All operations](https://skmtc.dev/alchemillahq/apis/sylve-api/llms.txt) · [OpenAPI document](https://skmtc.dev/alchemillahq/apis/sylve-api/revisions/ead7013c16a6?raw)