---
title: "List runtime controllers"
method: GET
path: "/api/runtime-controllers"
tags: ["Runtime pools"]
---

# List runtime controllers

`GET /api/runtime-controllers`

## Request

- Base URL: `http://localhost:3013`
- URL: `http://localhost:3013/api/runtime-controllers`
- Auth: HTTP bearer

## Response `200`

Success

- object
  - `controllers` RuntimeController[], required
    - `name` string, required
    - `kind` 'static' | 'docker' | 'e2b' | 'boxd' | 'k8s', required
    - `placement` 'builtin' | 'remote'
    - `config` object
    - `id` string, required
    - `secretConfigKeys` string[], required
    - `secretConfigError` boolean
    - `status` 'online' | 'offline' | 'unknown', required
    - `lastSeenAt` 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-29** `03ff25ddf270`: 1 warning
  - added the new `boxd` enum value to the `controllers/items/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-controllers/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)