API Reference

Complete API reference for all Puchify resources.

All endpoints are under https://api.puchify.com/api/v1. Every request requires authentication via Authorization: Bearer pk_xxxx.

Servers

Full CRUD + restart, destroy, reconcile

GPU Servers

GPU-accelerated server management

Data

Managed Postgres, MySQL, Redis, Valkey

Kubernetes

Managed Kubernetes clusters

Jobs

Scheduled and on-demand job execution

Storage

Object storage + file shares

Load Balancers

HTTP/TCP load balancing

VPN Gateways

Site-to-site VPN connectivity

ArrowUpFromLine

NAT Gateways

Outbound internet for private resources

Backups

Snapshot and restore

Observability

Fetch metrics, alerts, and incidents

Logs

Fetch and search centralized log data

ChartNoAxesColumnIncreasing

Usage

Usage and billing data

Settings

Profile, team, and API keys

Terminal

Terminal session management

Agent

AI agent threads and messages

Webhooks

Webhook subscriptions and deliveries

Common query parameters

Parameter	Type	Description
`cursor`	string	Pagination cursor from previous response
`limit`	integer (1-100)	Results per page (default 50)
`sort`	string	Sort field (`name`, `created_at`)
`order`	`asc` \| `desc`	Sort direction (default `desc`)

Common status codes

Code	Meaning
`200`	Success
`201`	Created
`400`	Validation error
`401`	Invalid or missing API key
`404`	Resource not found
`429`	Rate limit exceeded
`500`	Internal server error

Core Concepts

Understanding the Puchify object model, resource lifecycle, and API design.

Servers API

Create, manage, and connect to cloud servers.

On this page

Common query parameters Common status codes