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"
}