Skip to main content
PATCH
Update a pod

Authorizations

X-API-Key
string
header
required

A compute API key (x402c_...). Mint one in the dashboard under Settings -> API Keys. This is the ONLY auth /pods/v1/* accepts - wallet signatures are bound to method+path+body and do not survive the internal hop, so signature callers must use the dashboard routes instead. Two extra scopes gate the dangerous powers: pods:wallet:write (pod wallet money, backup passphrase) and pods:control:write (connectors, full-power control socket).

Path Parameters

id
string<uuid>
required

Pod id, as returned by create/list.

Body

application/json
name
string
Maximum string length: 120
model
string

Clamped to the pod's tier; an out-of-tier value is refused, not silently honoured.

slug
string | null

Vanity endpoint slug, globally unique. null clears it back to the uuid form.

auto_renew
boolean
ai
object

BYOK only. Refused on a managed pod.

Response

The pod, re-read after the change. PATCH, GET and create all render through the same serializer, so they cannot disagree.

pod
object

The public projection of a pod on /pods/v1. An allowlist: it never carries the engine, its version, the provider, the region, the machine plan, the IP, or any credential, so the pod's implementation can change without breaking your integration.