---
title: "Create a testbed"
method: POST
path: "/v0/projects/{project}/testbeds"
tags: ["projects", "testbeds"]
---

# Create a testbed

`POST /v0/projects/{project}/testbeds`

Create a testbed for a project. The user must have `create` permissions for the project, or provide a valid project key for the project.

## Path parameters

- `project` string, required

## Request body

- JsonNewTestbed
  - `name` string, required
  - `slug` string
  - `spec` string

## Response `201`

successful creation

- JsonTestbed
  - `archived` string, date-time
  - `created` string, date-time, required
  - `modified` string, date-time, required
  - `name` string, required
  - `project` string, uuid, required
  - `slug` string, required
  - `spec` 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
  - `uuid` string, uuid, required

## Other responses

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

## Changes

- **2026-03-23** `1634d744359e` — 2 info
  - added the optional property `spec/allOf[#/components/schemas/JsonSpec]/sandbox` to the response with the `201` status
  - added the required property `spec/allOf[#/components/schemas/JsonSpec]/os` to the response with the `201` status
- **2026-03-20** `36c8ad753527` — 1 breaking, 1 warning
  - removed the required property `spec/allOf[#/components/schemas/JsonSpec]/os` from the response with the `201` status
  - removed the optional property `spec/allOf[#/components/schemas/JsonSpec]/sandbox` from the response with the `201` status

[Change history](https://skmtc.dev/bencherdev/apis/bencher-api/changes/v0/projects/:project/testbeds/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/74e9728a444e/schema)