---
title: "Patch Endpoint Settings"
method: PATCH
path: "/endpoints/{endpoint_id}"
tags: ["Endpoints"]
---

# Patch Endpoint Settings

`PATCH /endpoints/{endpoint_id}`

Update runtime settings for an inactive endpoint. At least one field must be provided. Stop the endpoint first if it is active.

## Path parameters

- `endpoint_id` string, required

## Request body

- EndpointPatchInput
  - `container_start_command` string, nullable — Container start command.
  - `container_env_vars` object[], nullable — Container environment variables.
    - `key` string — Environment variable key.
    - `value` string — Environment variable value.
  - `container_port` integer, nullable — Container service port (1-65535).
  - `container_health_check_path` string, nullable — Health check endpoint path.
  - `container_health_check_timeout` integer, nullable — Container health check timeout in seconds.
  - `health_check_timeout` integer, nullable — Overall health check timeout in seconds. Deployment fails if health check does not pass within this time.
  - `container_metric_path` string, nullable — Prometheus metrics endpoint path.

## Response `200`

Updated endpoint settings.

- EndpointPatchResponse
  - `endpoint_id` string — Unique endpoint ID.
  - `name` string — Endpoint name.
  - `is_active` boolean — Active status (always false after successful patch).
  - `container_start_command` string, nullable — Current start command.
  - `container_env_vars` object[], nullable — Current environment variables.
  - `container_port` integer, nullable — Current port.
  - `container_health_check_path` string, nullable — Current health check path.
  - `container_health_check_timeout` integer, nullable — Current health check timeout.
  - `health_check_timeout` integer, nullable — Current overall health check timeout.
  - `container_metric_path` string, nullable — Current metric path.
  - `updated_at` string, date-time — Update time.

## Other responses

- `400` — No patch field provided.
- `409` — Endpoint is active. Stop it first.

---

[API](https://skmtc.net/aieev/apis/aircloud-external-api.md) · [All operations](https://skmtc.net/aieev/apis/aircloud-external-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aieev/aircloud-external-api/versions/5cb76994bce9/schema)