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

# GET /v1/pools/{name}

`GET /v1/pools/{name}`

## Path parameters

- `name` string, required

## Response `200`

Pool detail

- Pool
  - `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)
- `404` — Pool not found
- `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)