Skip to main content
PATCH
Update a CI runner

Authorizations

x-brimble-key
string
header
required

API key created in the dashboard under Settings → API keys. Each key carries permission scopes; every endpoint lists the scope it needs.

Path Parameters

id
string
required

ID of the CI runner.

Pattern: ^[a-fA-F0-9]{24}$

Body

application/json
name
string

Name of the runner, up to 64 characters.

Required string length: 1 - 64
mode
enum<string>

How jobs run. Switching to per_job needs a size and region, in this request or already on the runner.

Available options:
reuse,
per_job
size
string

Sandbox size for each job in per_job mode, for example sbx.small.

region
string

ID of the sandbox region for per_job mode.

Pattern: ^[a-fA-F0-9]{24}$
maxConcurrency
integer

Most sandboxes to run at once in per_job mode.

Required range: 1 <= x <= 20
enabled
boolean

Whether the runner picks up jobs.

Response

CI runner updated

message
string
required

Human-readable result of the request.

Example:

"CI runner updated"

data
object
required
Last modified on November 10, 2026