---
title: "Get a runner registration token"
method: GET
path: "/api/v3/workspaces/{workspace}/runner-token"
tags: ["Workspace Configuration"]
---

# Get a runner registration token

`GET /api/v3/workspaces/{workspace}/runner-token`

Generate a registration token used to enroll a new runner at a given location. Requires the workspace **admin** role. The runner (RunWhen Local / runner-control) uses the returned token to register and obtain its upload/config credentials.

## Path parameters

- `workspace` string, required

## Query parameters

- `location` string, required

## Response `200`

Runner registration token + registration details

## Other responses

- `403` — Admin permission required
- `404` — Workspace not found
- `422` — Missing location or runner request failed
- `503` — Runner service unavailable

---

[API](https://skmtc.dev/runwhen/apis/runwhen-platform-api.md) · [All operations](https://skmtc.dev/runwhen/apis/runwhen-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/runwhen/runwhen-platform-api/revisions/9d1a64d4b1c1/schema)