---
title: "Get a runtime pool"
method: GET
path: "/api/runtime-pools/{id}"
tags: ["Runtime pools"]
---

# Get a runtime pool

`GET /api/runtime-pools/{id}`

## Request

- Base URL: `http://localhost:3013`
- URL: `http://localhost:3013/api/runtime-pools/{id}`
- Auth: HTTP bearer

## Path parameters

- `id` string, required

## Response `200`

Success

- object
  - `pool` RuntimePool, required
    - `name` string, required
    - `kind` 'static' | 'docker' | 'e2b' | 'boxd' | 'k8s', required
    - `placements` string[], required
    - `image` string, nullable
    - `lifecycle` 'idle' | 'per-task'
    - `idleMinutes` integer, nullable
    - `slotsPerRuntime` integer
    - `maxRuntimes` integer, nullable
    - `minRuntimes` integer
    - `delivery` 'poll' | 'push' | 'null', nullable
    - `env` object
    - `resources` object, nullable
      - `cpu` number
      - `memoryMb` integer
    - `cache` object, nullable
      - `mountPath` string, required
    - `ttlSec` integer, nullable
    - `enabled` boolean
    - `id` string, required
    - `resolvedImage` string, nullable, required
    - `consecutiveFailures` integer, required
    - `circuitOpenUntil` string, nullable, required
    - `lastError` string, nullable, required
    - `lastErrorAt` string, nullable, required
    - `createdBy` string, nullable, required
    - `updatedBy` string, nullable, required
    - `createdAt` string, required
    - `updatedAt` string, required

## Other responses

- `400`: Invalid configuration
- `403`: Permission denied
- `404`: Not found or runtime pools disabled

## Changes

- **2026-10-30** `2726b97e6ecb`: 1 info
  - added the optional property `pool/cache` to the response with the `200` status
- **2026-10-29** `03ff25ddf270`: 1 warning
  - added the new `boxd` enum value to the `pool/kind` response property for the response status `200`
- **2026-10-12** `2d005144fe35`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/desplega-ai/apis/agent-swarm-api/changes/api/runtime-pools/:id/get.md)

---

[API](https://skmtc.dev/desplega-ai/apis/agent-swarm-api.md) - [All operations](https://skmtc.dev/desplega-ai/apis/agent-swarm-api/llms.txt) - [OpenAPI document](https://skmtc.dev/desplega-ai/apis/agent-swarm-api/revisions/7e4c7198192a?raw)