Skip to content

REST API Schemas

REST API request and response schemas.

Overview

All API endpoints use JSON Schema validated requests and responses.

Common Patterns

List Response

{
  "data": [],
  "paging": {
    "after": "cursor",
    "total": 100
  }
}

Create Request

{
  "name": "entity_name",
  "description": "Description",
  "owner": {"type": "user", "id": "uuid"}
}

Update Request (JSON Patch)

[
  {
    "op": "replace",
    "path": "/description",
    "value": "New description"
  }
]

Error Responses

{
  "code": 400,
  "message": "Validation error",
  "details": "Field 'name' is required"
}