API Reference

REST API

Programmatic access to manage your FireClaw agents. All endpoints require authentication via session cookie.

Base URL: https://fireclaw.ai

Authentication: Session-based (cookie). All requests must include a valid session cookie from signing in.

Rate Limits: 5 agent creations/hour, 10 payment operations/hour per user.

GET/api/agents

List all agents for the authenticated user.

Response

[{ "id": "...", "name": "My Agent", "status": "running", "domain": "my-agent.fireclaw.ai" }]

POST/api/agents

Create and deploy a new agent. Triggers provisioning on Hetzner Cloud.

Request Body

{ "name": "My Agent", "tier": "standard" }

Response

{ "id": "...", "name": "My Agent", "status": "provisioning" }

GET/api/agents/:id

Get details for a specific agent including status, domain, and server info.

Response

{ "id": "...", "name": "My Agent", "status": "running", "domain": "my-agent.fireclaw.ai", "ip": "..." }

PATCH/api/agents/:id

Perform actions on an agent: reboot, shutdown, power on, or delete.

Request Body

{ "action": "reboot" }

Response

{ "success": true }

GET/api/agents/:id/metrics

Retrieve CPU, memory, disk, and network metrics from Hetzner.

Response

{ "cpu": [...], "memory": [...], "disk": [...], "network": [...] }

GET/api/subscription

Get the current user's subscription tier, status, and quota.

Response

{ "tier": "standard", "status": "active", "agentLimit": 3, "agentCount": 1 }