---
title: "Bootstrap an account, workspace and first key (dev only)"
method: POST
path: "/v1/dev/bootstrap"
tags: ["meta"]
---

# Bootstrap an account, workspace and first key (dev only)

`POST /v1/dev/bootstrap`

## Request

- Base URL: `https://api.hyperresearch.ai`
- URL: `https://api.hyperresearch.ai/v1/dev/bootstrap`
- Auth: none required

Returns 404 unless the deployment is non-production and DEV_BOOTSTRAP_ENABLED is "true". Used by `pnpm seed:dev` and the test suite.

## Request body

- BootstrapBody
  - `email` string, email, required
  - `account_name` string
  - `workspace_name` string
  - `plan` 'payg' | 'team' | 'enterprise'
  - `card_on_file` boolean
  - `spend_cap_cents_month` integer
  - `key_prefix` 'hr_live_' | 'hr_test_' | 'hr_chat_'
  - `scopes` string[]

## Response `201`

Created

- BootstrapResult
  - `account_id` string, required
  - `user_id` string, required
  - `workspace_id` string, required
  - `key_id` string, required
  - `key` string, required

## Other responses

- `400`: Invalid request
- `401`: Authentication failed
- `403`: Insufficient scope or plan
- `404`: Not found
- `429`: Rate limited or over quota
- `500`: Internal error

---

[API](https://skmtc.dev/hyperresearch/apis/hyperresearch-cloud-api.md) · [All operations](https://skmtc.dev/hyperresearch/apis/hyperresearch-cloud-api/llms.txt) · [OpenAPI document](https://skmtc.dev/hyperresearch/apis/hyperresearch-cloud-api/revisions/726ef831ebf4?raw)