---
title: "Add a spec to a runner"
method: POST
path: "/v0/runners/{runner}/specs"
tags: ["runners"]
---

# Add a spec to a runner

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

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

## Path parameters

- `runner` string, required

## Request body

- JsonNewRunnerSpec — Add a spec to a runner
  - `spec` string, required

## Response `201`

successful creation

- JsonSpec — A hardware spec
  - `architecture` 'x86_64' | 'aarch64', required
  - `archived` string, date-time
  - `cpu` integer, required
  - `created` string, date-time, required
  - `disk` integer, required
  - `fallback` string, date-time
  - `memory` integer, required
  - `modified` string, date-time, required
  - `name` string, required
  - `network` boolean, required
  - `os` 'linux' | 'macos' | 'windows', required
  - `sandbox` 'firecracker'
  - `slug` string, required
  - `uuid` string, uuid, required

## Other responses

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

---

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