Skip to main content
Vintony HostPremium cloud

Provisioning a VPS via API

From `curl` to a running VPS in under 90 seconds.

3 min read

Provisioning a new VPS via the API is a single POST. Here's the smallest example that works.

bash
curl -X POST https://api.vintonyhost.com/v1/services \
  -H "Authorization: Bearer $VINT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"plan":"vps-growth","region":"lon1","image":"ubuntu-24.04","hostname":"web-01","ssh_keys":["ssh-ed25519 AAAA…"]}'

Response includes the service ID and initial credentials. Poll `GET /v1/services/{id}` until `status` is `running` (typically 60–90 seconds).

Region codes match the dashboard: `lon1`, `fra1`, `ams1`, `iad1`, `sfo1`, `tor1`, `gru1`, `sgp1`, `nrt1`, `bom1`, `syd1`, `hel1`. Pass `region` in the create request or set a default in your account settings.

Cleanup: `DELETE /v1/services/{id}` destroys the VPS and starts billing prorating immediately. There's no soft-delete grace; once you call delete, the data is gone.