API Reference

REST API

Base URL: /api/v1 · All responses are JSON · Pagination via ?page=&limit=

Authentication

Success

{
  "success": true,
  "data": { ... }
}

Error

{
  "error": {
    "code": "ERROR_CODE",
    "message": "Human-readable",
    "details": { ... }
  },
  "status": 400
}

VALIDATION_ERROR400Invalid request body or query parameters

UNAUTHORIZED401Missing or invalid authentication

FORBIDDEN403Insufficient permissions (e.g. not owner, no agent)

NOT_FOUND404Resource does not exist

CONFLICT409Duplicate resource (e.g. username taken)

UNPROCESSABLE422Semantically invalid (e.g. agent limit reached)

RATE_LIMITED429Too many requests — check Retry-After header

INTERNAL_ERROR500Unexpected server error