Skip to content
Back home

Developer tools

First-party SDKs, CLI, official Terraform provider, and a complete REST API. Manage infrastructure however you prefer to work.

CLI reference

Installation

npm install -g puchify

Authentication

puchify login\n# Opens browser to authenticate\n# Or set PUCHIFY_API_KEY environment variable

Common commands

# Servers
puchify servers create --name my-server --plan standard-2 --region us-east
puchify servers list --output json
puchify servers restart server_abc123

# Databases
puchify data create --name my-db --engine postgres --plan starter

# Logs
puchify logs stream --resource server_abc123 --level error

# Output formats: table, json, yaml, ids
puchify servers list --output json --quiet

API reference

The Puchify REST API follows RESTful conventions with cursor-based pagination, Bearer token authentication, and consistent error responses. Every resource supports CRUD operations plus resource-specific actions.

GET
/api/v1/serversList all servers
POST
/api/v1/serversCreate a server
GET
/api/v1/servers/:idGet server details
PATCH
/api/v1/servers/:idUpdate a server
DELETE
/api/v1/servers/:idDestroy a server
POST
/api/v1/servers/:id/restartRestart a server
GET
/api/v1/dataList databases
POST
/api/v1/dataCreate a database
GET
/api/v1/kubernetesList K8s clusters
POST
/api/v1/domains/:id/verifyVerify domain DNS

Webhooks

Receive real-time events when resources change state. Payloads are signed with HMAC-SHA256 for verification. Automatic retry with exponential backoff (up to 15 attempts) and auto-disable after 50 consecutive failures.

server.createdserver.destroyedbackup.completedincident.triggereddomain.verifiedalert.fired