---
title: "Create Bench Token"
method: POST
path: "/api/v1/admin/bench-tokens"
tags: ["bench commissioning"]
---

# Create Bench Token

`POST /api/v1/admin/bench-tokens`

## Request

- Base URL: `https://api.brumby.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.brumby.com/api/v1/admin/bench-tokens`
- Auth: HTTP bearer

## Request body

- BenchTokenIssue
  - `label` string, required
  - `ttl_seconds` integer
  - `max_uses` integer, nullable

## Response `201`

Successful Response

- BenchTokenResponse: Returned once. The raw token is never stored and never shown again.
  - `token_id` string, uuid, required
  - `label` string, required
  - `token_hint` string, required
  - `scope` string, required
  - `issued_by_actor` string, required
  - `issued_at` string, date-time, required
  - `expires_at` string, date-time, required
  - `revoked_at` string, date-time, nullable, required
  - `uses` integer, required
  - `max_uses` integer, nullable, required
  - `usable` boolean, required
  - `bench_token` string, required
  - `bench_env` string, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/brumby/apis/brumby-platform-api.md) - [All operations](https://skmtc.dev/brumby/apis/brumby-platform-api/llms.txt) - [OpenAPI document](https://skmtc.dev/brumby/apis/brumby-platform-api/revisions/fe185e20813e?raw)