---
title: "Modify existing endpoint"
method: PATCH
path: "/endpoint/{id}"
tags: ["endpoint"]
deprecated: true
---

# Modify existing endpoint

`PATCH /endpoint/{id}`

> **Deprecated.**

Applies the endpoint change request to an existing endpoint

## Path parameters

- `id` string, required

## Request body

- EndpointChangeRequest — Structure which contains the mutable elements of an Endpoint.
  - `id` integer — Local endpoint ID
  - `container-id` string — ID assigned by container runtime
  - `container-netns-path` string — Path of Container Netns
  - `labels` string[] — Set of labels
  - `interface-name` string — Name of network device in host netns
  - `interface-index` integer — Index of network device in host netns
  - `parent-interface-index` integer — Index of network device from which an IP was used as endpoint IP. Only relevant for ENI environments.
  - `container-interface-name` string — Name of network device in container netns
  - `state` 'waiting-for-identity' | 'not-ready' | 'waiting-to-regenerate' | 'regenerating' | 'restoring' | 'ready' | 'disconnecting' | 'disconnected' | 'invalid', required — State of endpoint
  - `mac` string — MAC address
  - `host-mac` string — MAC address
  - `addressing` AddressPair — Addressing information of an endpoint
    - `ipv4` string — IPv4 address
    - `ipv4-expiration-uuid` string — UUID of IPv4 expiration timer
    - `ipv4-pool-name` string — IPAM pool from which this IPv4 address was allocated
    - `ipv6` string — IPv6 address
    - `ipv6-expiration-uuid` string — UUID of IPv6 expiration timer
    - `ipv6-pool-name` string — IPAM pool from which this IPv6 address was allocated
  - `k8s-pod-name` string — Kubernetes pod name
  - `k8s-namespace` string — Kubernetes namespace name
  - `k8s-uid` string — Kubernetes pod UID
  - `datapath-map-id` integer — ID of datapath tail call map
  - `policy-enabled` boolean — Whether policy enforcement is enabled or not
  - `pid` integer — Process ID of the workload belonging to this endpoint
  - `sync-build-endpoint` boolean — Whether to build an endpoint synchronously
  - `is-secondary-interface` boolean — Whether this is a secondary pod interface
  - `netns-cookie` string — Network namespace cookie
  - `datapath-configuration` EndpointDatapathConfiguration — Datapath configuration to be used for the endpoint
    - `require-arp-passthrough` boolean — Enable ARP passthrough mode
    - `require-egress-prog` boolean — Endpoint requires a host-facing egress program to be attached to implement ingress policy and reverse NAT.
    - `external-ipam` boolean — Indicates that IPAM is done external to Cilium. This will prevent the IP from being released and re-allocation of the IP address is skipped on restore.
    - `require-routing` boolean — Endpoint requires BPF routing to be enabled, when disabled, routing is delegated to Linux routing.
    - `install-endpoint-route` boolean — Installs a route in the Linux routing table pointing to the device of the endpoint's interface.
    - `disable-sip-verification` boolean — Disable source IP verification for the endpoint.
  - `properties` unknown

## Response `200`

Success

## Other responses

- `400` — Invalid modify endpoint request
- `403` — Forbidden
- `404` — Endpoint does not exist
- `429` — Rate-limiting too many requests in the given time frame
- `500` — Endpoint update failed
- `503` — Service Unavailable

---

[API](https://skmtc.net/cilium/apis/cilium-api.md) · [All operations](https://skmtc.net/cilium/apis/cilium-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cilium/cilium-api/versions/351336b27221/schema)