Skip to main content

​
Base URL

All API requests are made to: 
https://api.pocketenv.io/xrpc/

​
Authentication

Every endpoint requires a Bearer token in the Authorization header. 
Authorization: Bearer <your-token>
You can retrieve a token via the Pocketenv dashboard or by authenticating through the AT Protocol flow.

​
Errors

All errors return a JSON body with error and message fields.
StatusMeaning
400Bad request — invalid parameters or missing fields
401Unauthorized — missing or invalid Bearer token
{
  "error": "InvalidRequest",
  "message": "Missing required field: sandboxId"
}

​
Resources

ResourceDescription
ActorUser profile and account-level sandbox access
SandboxesFull sandbox lifecycle — create, start, stop, exec, delete
FilesRead and write files inside a sandbox
SecretsEncrypted key-value secrets scoped to a sandbox
VariablesEnvironment variables for sandbox configuration
ServicesLong-running processes inside a sandbox
VolumesPersistent storage volumes attached to sandboxes