---
title: "Create a runner"
method: POST
path: "/v0/runners"
tags: ["runners"]
---

# Create a runner

`POST /v0/runners`

➕ Bencher Plus: Create a new runner on the server. The user must be an admin to use this endpoint. Returns the runner token which is only shown once.

## Request body

- JsonNewRunner — Create a new runner
  - `name` string, required
  - `slug` string

## Response `201`

successful creation

- JsonRunnerToken — Runner token response (returned on create or rotate)
  - `token` string, required
  - `uuid` string, uuid, required

## Other responses

- `4XX` — Error
- `5XX` — Error

## Changes

- **2026-03-20** `36c8ad753527` — 1 breaking, 1 info
  - removed the required property `key` from the response with the `201` status
  - added the required property `token` to the response with the `201` status

[Change history](https://skmtc.dev/bencherdev/apis/bencher-api/changes/v0/runners/post.md)

---

[API](https://skmtc.dev/bencherdev/apis/bencher-api.md) · [All operations](https://skmtc.dev/bencherdev/apis/bencher-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bencherdev/bencher-api/revisions/36c8ad753527/schema)