Runner Specs REST API

List specs for a runner

⚠️ Breaking Changes: The Bencher API is in beta and under active development. We may introduce breaking changes in future releases. We will announce any breaking changes in the release notes.

➕ Bencher Plus: List all hardware specs associated with a runner. The user must be an admin to use this endpoint.

Headers

Content-Type

string

Required

Set to application/json.

Authorization

string

Required

Set to Bearer BENCHER_API_TOKEN, where BENCHER_API_TOKEN is a vaild Bencher API token.

Path Parameters

runner
Required

The slug or UUID for a runner.

GET
/v0/runners/{runner}/specs
Bencher Cloud https://api.bencher.dev
Bencher Self-Hosted http://localhost:61016

Bencher CLI

bencher runner spec list RUNNER

View OpenAPI Spec

Add a spec to a runner

⚠️ Breaking Changes: The Bencher API is in beta and under active development. We may introduce breaking changes in future releases. We will announce any breaking changes in the release notes.

➕ Bencher Plus: Associate a hardware spec with a runner. The user must be an admin to use this endpoint.

Headers

Content-Type

string

Required

Set to application/json.

Authorization

string

Required

Set to Bearer BENCHER_API_TOKEN, where BENCHER_API_TOKEN is a vaild Bencher API token.

Path Parameters

runner
Required

The slug or UUID for a runner.

Body Parameters

spec
Required

The UUID or slug of the spec to associate with the runner.

POST
/v0/runners/{runner}/specs
Bencher Cloud https://api.bencher.dev
Bencher Self-Hosted http://localhost:61016

Bencher CLI

bencher runner spec add RUNNER

View OpenAPI Spec

Remove a spec from a runner

⚠️ Breaking Changes: The Bencher API is in beta and under active development. We may introduce breaking changes in future releases. We will announce any breaking changes in the release notes.

➕ Bencher Plus: Remove the association between a hardware spec and a runner. The user must be an admin to use this endpoint.

Headers

Content-Type

string

Required

Set to application/json.

Authorization

string

Required

Set to Bearer BENCHER_API_TOKEN, where BENCHER_API_TOKEN is a vaild Bencher API token.

Path Parameters

runner
Required

The slug or UUID for a runner.

spec
Required

The UUID or slug for a spec.

DELETE
/v0/runners/{runner}/specs/{spec}
Bencher Cloud https://api.bencher.dev
Bencher Self-Hosted http://localhost:61016

Bencher CLI

bencher runner spec remove RUNNER SPEC

View OpenAPI Spec

Published: Mon, February 12, 2024 at 7:26:00 AM UTC | Last Updated: Sun, December 7, 2025 at 5:47:00 PM UTC