Provider

One-command node onboarding installer (auth = org API key bearer, OR a pre-minted provisioning token via ?token=)

Returns a self-contained shell installer (curl | sudo bash). With a bearer org API key it mints a fresh provisioning token (24 hours, any number of nodes); with ?token=vtk_… (e.g. minted from the dashboard) it self-auths and embeds that token instead. name only applies when minting (the token already carries it). The runtime is detected on the box, not chosen here: a bare metal host enrolls as a qemu VM host with VFIO passthrough, and a virtualised guest enrolls as a runc pod host on its native NVIDIA or AMD driver. Either way the node joins the community pool.

get/v1/provider/bootstrap

Query parameters

tokenstring

Pre-minted provisioning token (vtk_…); replaces bearer auth

gpustring

Accepted for backward compatibility and ignored; it selects nothing. The runtime is detected on the box by enroll.sh (systemd-detect-virt), and enroll.sh takes --gpu only to discard it.

namestring

Token label; mint path only

Response

The installer script (contains a secret provisioning token, never cached)

Changes

No recorded changes to this endpoint across all 36 revisions of this API.