v1

latestOpenAPI 3.1.02026-07-2676123203.9 KB

Serverless

List serverless endpoint workers

Lists the active workers for a serverless endpoint.

Returns. A 200 with a ListEndpointWorkersResponse: a workers array (one entry per active worker, each carrying its id, status, and runtime details) plus a summary of worker counts grouped by status. Only currently active workers are included; scaled-down workers are not returned.

How status is determined. Each worker's status is derived by reconciling the worker pod's lifecycle status with the endpoint's live job-queue view (which workers are actively serving requests). When the job-queue view is unavailable, the response degrades gracefully: the shape is unchanged, but each status and the summary counts fall back to pod lifecycle alone.

get/v2/serverless/{id}/workers

Response

endpointVersioninteger nullable

The endpoint's current configuration version. A worker whose version differs is running stale config (see worker.isStale). Null if unknown.

Example response

{
  "workers": [
    {
      "id": "worker_abc",
      "version": 4,
      "gpuCount": 1,
      "image": "my-org/sdxl-worker:latest",
      "uptimeSeconds": 3600,
      "gpuTypeId": "NVIDIA RTX 4090",
      "dataCenterId": "US-TX-3",
      "startedAt": "2026-03-26T00:00:00Z"
    }
  ],
  "summary": {
    "running": 2,
    "idle": 1,
    "total": 3
  },
  "endpointVersion": 4
}