---
title: "Issue a one-time bootstrap token for a bring-your-own server"
method: POST
path: "/platform/servers/external/bootstrap"
tags: ["Platform"]
---

# Issue a one-time bootstrap token for a bring-your-own server

`POST /platform/servers/external/bootstrap`

## Request

- Base URL: `https://api.imprezahost.com/v1`
- URL: `https://api.imprezahost.com/v1/platform/servers/external/bootstrap`
- Auth: API key in header `X-API-Key` and API key in header `X-API-Secret`

Generates a single-use token (~10 min TTL) plus the curl-pipe
one-liner that installs the agent on a Linux host you own. The
agent self-registers on first contact and joins your fleet.
The first external server is free on every account: Starter
(no Impreza service) allows 1, Bundled (any active Impreza VPS) 5,
and the Unlimited plan has no limit. `used` counts registered
external servers plus install tokens not yet used, this one
included. New external servers are also limited per day (429).
The token is returned once; only its hash is stored.

## Request body

- object
  - `label` string: Optional friendly label for the agent (plain text without control characters, up to 120 characters, shown on My Apps panel).

## Response `201`

Bootstrap token issued

## Other responses

- `400`: Invalid label (INVALID_REQUEST)
- `401`: Invalid or missing API credentials
- `409`: External server quota reached (QUOTA_EXCEEDED); next_steps names the Bundled tier
- `429`: Daily limit on new external servers reached (RATE_LIMITED)

---

[API](https://skmtc.dev/imprezahost/apis/impreza-host-public-api.md) · [All operations](https://skmtc.dev/imprezahost/apis/impreza-host-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/imprezahost/apis/impreza-host-public-api/revisions/db86511f604f?raw)