Platform
Issue a one-time bootstrap token for a bring-your-own server
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.
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
Request body
Example request
{
"label": "home-office-nuc"
}Response
Bootstrap token issued
Changes
No recorded changes to this operation across all 1 revision of this API.