---
title: "Update a runtime controller"
method: PATCH
path: "/api/runtime-controllers/{id}"
tags: ["Runtime pools"]
---

# Update a runtime controller

`PATCH /api/runtime-controllers/{id}`

## Request

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

## Path parameters

- `id` string, required

## Request body

- object
  - `name` string
  - `kind` 'static' | 'docker' | 'e2b' | 'boxd' | 'k8s'
  - `placement` 'builtin' | 'remote'
  - `config` object
  - `secretConfig` object

## Response `200`

Success

- object
  - `controller` 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
- `409`: Entity is in use or already exists

## Changes

- **2026-10-29** `03ff25ddf270`: 1 warning, 1 info
  - added the new `boxd` enum value to the `controller/kind` response property for the response status `200`
  - added the new `boxd` enum value to the request property `kind`
- **2026-10-12** `2d005144fe35`: 1 info
  - endpoint added

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