---
title: "Rotate runner key"
method: POST
path: "/v0/runners/{runner}/key"
tags: ["runners"]
---

# Rotate runner key

`POST /v0/runners/{runner}/key`

➕ Bencher Plus: Generate a new key for a runner, invalidating the old one. The user must be an admin to use this endpoint. Returns the new key which is only shown once.

## Path parameters

- `runner` string, required

## Response `201`

successful creation

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

## Other responses

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

## Changes

- **2026-05-02** `63c5dc652bf7` — 2 info
  - added `#/components/schemas/RunnerKey` to the `key` response property `allOf` list for the response status `201`
  - removed `#/components/schemas/Secret` from the `key` response property `allOf` list for the response status `201`
- **2026-04-19** `d43622fab2af` — 1 info
  - endpoint added
- **2026-03-20** `36c8ad753527` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/bencherdev/apis/bencher-api/changes/v0/runners/:runner/key/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/71cd0a41ffd9/schema)