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

# List pool runtimes

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

## Request

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

## Path parameters

- `id` string, required

## Response `200`

Success

- object
  - `runtimes` RuntimeInstance[], required
    - `id` string, required
    - `agentId` string, required
    - `status` 'active' | 'offline' | 'provisioning', required
    - `poolId` string, nullable
    - `controllerId` string, nullable
    - `externalHandle` object, nullable
    - `provisionAttempts` integer
    - `provisionError` string, nullable
    - `provisionRequestedAt` string, nullable
    - `draining` boolean
    - `idleSince` string, nullable
    - `leaseExpiresAt` string, nullable
    - `taskId` string, nullable
    - `reportedSlots` integer, required
    - `credentialReady` boolean, nullable
    - `metadata` object, nullable, required
    - `lastSeenAt` string, date-time, required
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required

## Other responses

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

## Changes

- **2026-10-12** `2d005144fe35`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/desplega-ai/apis/agent-swarm-api/changes/api/runtime-pools/:id/runtimes/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)