Skip to main content
Integrate with EasyClaw programmatically.

​
Base URL

https://api.easyclaw.app
The EasyClaw API is a REST API. All requests require authentication.

​
Authentication

Every request must include a valid session token: 
curl https://api.easyclaw.app/session \
  -H "Authorization: Bearer YOUR_TOKEN"
The token is obtained through the authentication flow (email/password or OAuth sign-in).

​
Endpoints

​
Sessions

MethodPathDescription
GET/sessionGet current session status
POST/session/spawnStart a new container
POST/session/freezeFreeze the active container
POST/session/restoreRestore a frozen container
POST/session/killDestroy the container

​
Credentials

MethodPathDescription
GET/credentialsList stored credentials
POST/credentialsStore an API key (encrypted)
DELETE/credentials/:idRemove a credential

​
Usage

MethodPathDescription
GET/usageGet token usage and cost for current period
GET/usage/historyHistorical usage data

​
WebSocket

PathDescription
/ws/terminalTerminal session to your container
/ws/gatewayZeroClaw gateway connection (real-time chat)
WebSocket connections are proxied from the API to your container. The API authenticates the connection and then tunnels traffic directly.

Session management

Detailed session lifecycle API.

​
Rate limits

PlanRequests per minute
Free30
Pro120
Ultra300

​
Error format

All errors return JSON with a consistent structure: 
{
  "error": "not_found",
  "message": "Session not found for this user"
}
Common error codes:
CodeHTTP StatusDescription
unauthorized401Missing or invalid auth token
forbidden403Insufficient plan or permissions
not_found404Resource doesn’t exist
rate_limited429Too many requests
server_error500Internal error