API reference
Astropods REST API for agents, deployments, and accounts
The Astropods API is the API the ast CLI and the Astropods dashboard use. Every endpoint they call is in this reference.
Base URL
Endpoint paths in this reference include the /api/v1 prefix.
WebSocket endpoints, such as a sandbox terminal, use the same host over wss://.
Authentication
Send a bearer token in the Authorization header:
Each endpoint lists the token it accepts. A few endpoints, such as listing public agents, need no token.
Errors
A failed request returns a JSON body:
error describes the failure. Some endpoints add details with more context, and a code you can match on.