---
title: "GET /v1/pools"
method: GET
path: "/v1/pools"
tags: ["pools"]
---

# GET /v1/pools

`GET /v1/pools`

## Response `200`

Pools visible to this gateway replica

- PoolListResponse
  - `pools` Pool[], required
    - `spec` PoolSpec, required
      - `bundle` string, nullable
      - `gpu_caps` object
      - `gpus` object
      - `minimum_worker_count` integer — Per-pool warm floor: the minimum number of machines the gateway keeps warm (via KEDA) so the first request to the pool never hits a cold VM. The gateway publishes it as `sie.gateway.pool.warm_floor`; the collector translates it for KEDA's Prometheus query. Default 0 leaves scale-from-zero unchanged.
      - `name` string, required
      - `pinned_models` string[] — Per-pool pinned-model set: models the gateway keeps loaded so the first request to them pays no cold model-load. Chosen from the models the gateway already tracks (see `GET /v1/configs/models`); ids may be profile-qualified (`model-name:profile_name`). Default empty leaves lazy-loading unchanged.
      - `queue_pool` string — Physical Helm/NATS queue namespace backing this logical API pool. API-created pools default to the Helm `default` queue pool. Pool `name` is user/dynamic; a non-default `queue_pool` is infra/admin and must match a Helm worker queue declared under `queueRouting.staticQueuePools`.
      - `ttl_seconds` integer, nullable
    - `status` PoolStatus, required
      - `assigned_workers` AssignedWorker[]
        - `bundle` string
        - `gpu` string, required
        - `name` string, required
        - `url` string, required
      - `created_at` number, double
      - `last_renewed` number, double
      - `state` 'pending' | 'active' | 'expired', required

## Other responses

- `401` — Missing or invalid bearer token (inference token)
- `500` — Gateway auth enabled but no tokens configured

---

[API](https://skmtc.net/superlinked/apis/sie-gateway.md) · [All operations](https://skmtc.net/superlinked/apis/sie-gateway/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/superlinked/sie-gateway/versions/840fee92bd27/schema)