Make a server at a cloud provider and join it to a cluster over your tailnet (team admins). Read the locations, server types and prices with getCloudOptions first. Its startup script holds only one-time keys: on its first boot it joins your tailnet, then fetches its join details from Pyo over the tailnet. Pyo labels it as this installation's and puts it behind a firewall that allows only the web (80 and 443) and Tailscale. Follow it in cloudServers of getState: creating, booting, joining, then ready. Without confirm it answers 409 with the monthly price. Confirm that with the user, then send it again with confirm: true.
API key access: full.
apiKeyAuthorizationBearer <pyo_…>An API key from the dashboard's API keys page: Authorization: Bearer pyo_…. Keys can expire, and an expired one gets a 401.
application/jsonMake a server at a cloud provider and join it to a cluster over your tailnet (team admins). Read the locations, server types and prices with getCloudOptions first. Its startup script holds only one-time keys: on its first boot it joins your tailnet, then fetches its join details from Pyo over the tailnet. Pyo labels it as this installation's and puts it behind a firewall that allows only the web (80 and 443) and Tailscale. Follow it in cloudServers of getState: creating, booting, joining, then ready. Without confirm it answers 409 with the monthly price. Confirm that with the user, then send it again with confirm: true.
API key access: full.
op*"createCloudServer""createCloudServer"id*stringA new id you choose: cs_ then 4 to 40 lowercase letters, digits, dashes or underscores.
clusterId*stringname*stringIts name in the cluster, on your tailnet and at the provider.
provider?|"hetzner" (the default).
location*stringA location's name from getCloudOptions ("fsn1").
serverType*stringA server type's name from getCloudOptions ("cx22").
builder?booleanA build-only server: only Pyo's builder runs on it.
sshKey?|Your OpenSSH public key, to sign in to it over your tailnet.
tags?array<string>confirm?booleanDone. Always ok: true, and some operations add more, such as a new API key or a join command. A warning comes with a change that went through but won't fully take effect yet, such as more replicas than the servers have room for.
application/jsoncurl -X POST 'https://your-pyo.example.com/api/v1/ops' \
-H 'Content-Type: application/json' \
-d '{
"clusterId": "cl_8kq2x7ad",
"id": "cs_8kq2x7ad",
"location": "Singapore, SG",
"name": "web",
"op": "createCloudServer",
"serverType": "cx22"
}'{}