---
title: "Update endpoint, this can also be used to start or stop a dedicated endpoint"
method: PATCH
path: "/endpoints/{endpointId}"
tags: ["Endpoints"]
---

# Update endpoint, this can also be used to start or stop a dedicated endpoint

`PATCH /endpoints/{endpointId}`

Updates an existing endpoint's configuration. You can modify the display name, autoscaling settings, or change the endpoint's state (start/stop).

## Path parameters

- `endpointId` string, required — The ID of the endpoint to update

## Request body

- object
  - `display_name` string — A human-readable name for the endpoint
  - `state` 'STARTED' | 'STOPPED' — The desired state of the endpoint
  - `autoscaling` Autoscaling — Configuration for automatic scaling of replicas based on demand.
    - `min_replicas` integer, required — The minimum number of replicas to maintain, even when there is no load
    - `max_replicas` integer, required — The maximum number of replicas to scale up to under load
  - `inactive_timeout` integer, nullable — The number of minutes of inactivity after which the endpoint stops automatically. Set to 0 to disable automatic timeout.

## Response `200`

200

- DedicatedEndpoint — Details about a dedicated endpoint deployment
  - `object` 'endpoint', required — The object type, which is always `endpoint`.
  - `id` string, required — Unique identifier for the endpoint
  - `name` string, required — System name for the endpoint
  - `display_name` string, required — Human-readable name for the endpoint
  - `model` string, required — The model deployed on this endpoint
  - `hardware` string, required — The hardware configuration used for this endpoint
  - `type` 'dedicated', required — The type of endpoint
  - `owner` string, required — The owner of this endpoint
  - `state` 'PENDING' | 'STARTING' | 'STARTED' | 'STOPPING' | 'STOPPED' | 'ERROR', required — Current state of the endpoint
  - `autoscaling` Autoscaling, required — Configuration for automatic scaling of replicas based on demand.
    - `min_replicas` integer, required — The minimum number of replicas to maintain, even when there is no load
    - `max_replicas` integer, required — The maximum number of replicas to scale up to under load
  - `created_at` string, date-time, required — Timestamp when the endpoint was created

## Other responses

- `403` — Unauthorized
- `404` — Not Found
- `500` — Internal error

---

[API](https://skmtc.net/together/apis/together-apis.md) · [All operations](https://skmtc.net/together/apis/together-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/together/together-apis/revisions/f26a23fab8e0/schema)