---
title: "Update a runner pool"
method: PATCH
path: "/runners/runner-pools/{poolId}"
tags: ["Self-Hosted Runners"]
---

# Update a runner pool

`PATCH /runners/runner-pools/{poolId}`

Updates an existing runner pool

## Path parameters

- `poolId` string, required

## Request body

- UpdateRunnerPoolRequest
  - `name` string — Name of the runner pool
  - `labels` string[] — Labels to assign to the runner pool
  - `description` string — Description of the runner pool

## Response `200`

Runner pool updated successfully

- RunnerPool
  - `id` string — Unique identifier for the runner pool
  - `name` string — Name of the runner pool
  - `accountId` string — ID of the account the pool belongs to
  - `labels` string[] — Labels assigned to the runner pool
  - `description` string — Description of the runner pool
  - `runnersCount` integer — Number of runners in the pool
  - `assignedProjectsCount` integer — Number of projects assigned to this pool
  - `assignedWorkspaceCount` integer — Number of workspaces assigned to this pool
  - `assignedProjects` object[] — List of projects assigned to this pool
    - `id` string
    - `name` string
  - `assignedWorkspaces` object[] — List of workspaces assigned to this pool
    - `id` string
    - `name` string
  - `health` PoolHealth
    - `poolStatus` 'healthy' | 'partial' | 'inactive' — Overall health status of the pool
    - `statusByRunner` object — Map of runner ID to runner health status
  - `createdAt` string, date-time — Timestamp when the pool was created
  - `updatedAt` string, date-time — Timestamp when the pool was last updated

## Other responses

- `400` — Bad Request Error
- `401` — Unauthorized Error
- `403` — Insufficient permissions
- `404` — Not Found Error
- `409` — Conflict Error
- `500` — Internal Server Error

---

[API](https://skmtc.net/firefly/apis/api-gateway.md) · [All operations](https://skmtc.net/firefly/apis/api-gateway/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/firefly/api-gateway/revisions/eea119b4113f/schema)