Skip to main content
GET
List pods

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).

Query Parameters

limit
integer
default:25
Required range: 1 <= x <= 100
cursor
string

Opaque cursor from a previous page's next_cursor. It is a compound cursor over (created_at, id), so ties never repeat or skip.

external_ref
string

Filter by YOUR id. Filtered in the query, so it pages correctly rather than filtering one fetched page.

Response

Your pods.

pods
object[]
next_cursor
string | null

Null when there is no further page.