API docs

The Teploy Cloud REST API — authenticate with a Bearer API key

Authentication

Every /api/v1 request needs an API key and an organization scope.

Manage API keys

Headers

Authorization: Bearer tp_live_...
X-Organization-Id: your-org-id

Example

curl https://cloud.teploy.com/api/v1/whoami \
  -H "Authorization: Bearer $TEPLOY_KEY" \
  -H "X-Organization-Id: $TEPLOY_ORG"

Keys are deny-by-default: each endpoint requires its read:/write: permission on the key. Lists return { items, total } envelopes.

Infrastructure

Servers

Manage VPS servers across providers

read:servers
write:servers
GET/api/v1/serversList servers
GET/api/v1/servers/{id}Get a server by id
POST/api/v1/serversProvision a server
DELETE/api/v1/servers/{id}Destroy a server
GET/api/v1/providersList providers and plans
GET/api/v1/providers/{provider}/regionsProvider regions
GET/api/v1/providers/{provider}/sizesProvider sizes

SSH keys

Public keys for new servers (no private key is stored or returned)

read:servers
write:servers
GET/api/v1/ssh-keysList the organization's public keys
POST/api/v1/ssh-keysImport a public key (an existing one is returned as is; 20 per organization)

DNS

DNS zones and records

read:dns
write:dns
GET/api/v1/dns/zonesList DNS zones
POST/api/v1/dns/recordsCreate a DNS record
DELETE/api/v1/dns/records/{id}Delete a DNS record

Storage

Object storage

read:storage
write:storage
POST/api/v1/storage/presignPresign an upload or download URL