Errors and pagination

Errors

{
  "success": false,
  "error": {
    "code": "FORBIDDEN",
    "message": "Admin or owner access required"
  }
}

Code	Status	Meaning
UNAUTHORIZED	401	Missing or invalid bearer token.
FORBIDDEN	403	Authenticated principal lacks permission.
NOT_FOUND	404	Resource is missing or hidden by tenant scope.
VALIDATION_ERROR	400	Request body or query parameters are invalid.
RATE_LIMITED	429	Request exceeded a rate, queue, or concurrency limit.
INTERNAL_ERROR	500	Unexpected server error.

Pagination

List endpoints return a shared envelope with a pagination object when paging is available.

{
  "success": true,
  "data": [],
  "pagination": {
    "page": 1,
    "pageSize": 20,
    "total": 150,
    "totalPages": 8
  }
}

Legacy route families may use limit instead of pageSize. New public docs should follow the OpenAPI reference for each endpoint.