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