API Reference

All paid endpoints use MPP on Tempo. Send an unauthenticated request, receive a 402, sign with your wallet, retry. Free endpoints use a zero-amount proof credential for identity.

Catalog

GET /v1/catalog/sizes free

Available server sizes with per-minute and hourly rates, specs, and create fees.

GET /v1/catalog/regions free

Available regions: nyc1 (New York), sfo3 (San Francisco), ams3 (Amsterdam).

GET /v1/catalog/images free

Available OS images: Ubuntu 24.04 LTS, Debian 12.

Servers

POST /v1/servers create fee + compute

Create a new server. Charge: create fee + (hourly rate × minutes / 60).

param	type	description
size *	string	small, medium, or large
region *	string	nyc1, sfo3, or ams3
image	string	OS image slug default: ubuntu-24-04-x64
minutes	integer	Prepaid minutes default: 1
ssh_key_ids	string[]	Key IDs to install
snapshot_id	string	Restore from snapshot

Returns: id, status, paid_until, minutes_purchased, total_charged

GET /v1/servers free (proof)

List your active servers. Requires wallet identity via proof credential.

GET /v1/servers/:id free (proof)

Server details including IP, root password, remaining time, and status.

Returns: id, ip, root_password, remaining_minutes, remaining_hours, status, paid_until

POST /v1/servers/:id/extend hourly × min / 60

Add prepaid time. Minimum charge $0.01.

param	type	description
minutes *	integer	Minutes to add

Returns: id, paid_until, minutes_added, charged

DELETE /v1/servers/:id free (proof)

Destroy server. Automatically snapshots before destroying. Snapshot retained 72 hours.

Returns: deleted, snapshot { id, expires_in_hours }

POST /v1/servers/:id/reboot $0.005

Reboot server.

POST /v1/servers/:id/power $0.005

Power on or off.

param	type	description
action *	string	on or off

Snapshots

GET /v1/servers/snapshots/list free (proof)

List your available snapshots. Snapshots expire 72 hours after creation.

SSH Keys

POST /v1/keys $0.001

param	type	description
name *	string	Display name
public_key *	string	Full public key (e.g. ssh-ed25519 AAAA...)

Returns: id, name, fingerprint

GET /v1/keys free (proof)

List your registered SSH keys.

DELETE /v1/keys/:id free (proof)

Remove an SSH key.