Skip to main content

API Reference Overview

This section documents the implemented local API surface in /apps/clawcontrol/app/api/**.

Base URL

http://127.0.0.1:3000
The API is local-only and not designed for internet exposure.

Response Conventions

Most endpoints return one of:
  • { "data": ... }
  • { "data": ..., "meta": ... }
  • { "error": "..." }

Common Status Codes

  • 200 success
  • 201 created
  • 400 invalid input
  • 403 forbidden (policy/gate)
  • 404 not found
  • 428 typed confirmation required
  • 500 server error
  • 502/503 upstream OpenClaw/gateway unavailable patterns

cURL-first Example

curl -sS "http://127.0.0.1:3000/api/work-orders?limit=10"

Grouped API Pages

Last updated

2026-02-09