Sign in
Endpoints

Get endpoint by ID

Retrieves details about a specific endpoint, including its current state, configuration, and scaling settings.

get/endpoints/{endpointId}

Path parameters

endpointIdstring required

The ID of the endpoint to retrieve

Example:endpoint-d23901de-ef8f-44bf-b3e7-de9c1ca8f2d7

Response

200

object'endpoint' required

The object type, which is always endpoint.

idstring required

Unique identifier for the endpoint

namestring required

System name for the endpoint

display_namestring required

Human-readable name for the endpoint

modelstring required

The model deployed on this endpoint

hardwarestring required

The hardware configuration used for this endpoint

type'dedicated' required

The type of endpoint

ownerstring required

The owner of this endpoint

state'PENDING' | 'STARTING' | 'STARTED' | 'STOPPING' | 'STOPPED' | 'ERROR' required

Current state of the endpoint

created_atstring date-time required

Timestamp when the endpoint was created

Example response

{
  "id": "endpoint-d23901de-ef8f-44bf-b3e7-de9c1ca8f2d7",
  "name": "devuser/deepseek-ai/DeepSeek-R1-a32b82a1",
  "display_name": "My DeepSeek R1 endpoint",
  "model": "deepseek-ai/DeepSeek-R1",
  "hardware": "8x_nvidia_h200_140gb_sxm",
  "type": "dedicated",
  "owner": "devuser",
  "state": "STARTED",
  "autoscaling": {
    "min_replicas": 2,
    "max_replicas": 5
  },
  "created_at": "2025-02-04T10:43:55.405Z"
}

Changes

Changed in 1 of the 14 revisions of this API.2

  • 0c4fdad774352See the full diff
    • ▲

      the autoscaling/max_replicas response's property type/format changed from integer/int32 to integer/ for status 200

      response-property-type-changed

    • ▲

      the autoscaling/min_replicas response's property type/format changed from integer/int32 to integer/ for status 200

      response-property-type-changed

    This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog