Schemas

Enable enforcement with [schema] enforce = true in config. See Schema Validation for the full concept.

List schema types

GET /api/kiwi/schemas

curl 'http://localhost:3333/api/kiwi/schemas'

["runbook", "concept", "episode"]

Get a schema

GET /api/kiwi/schemas/:type

string

required

Schema type name (matches the frontmatter type field).

curl 'http://localhost:3333/api/kiwi/schemas/runbook'

Returns the raw JSON Schema document.

Create or update a schema

PUT /api/kiwi/schemas/:type

string

required

Schema type name.

The request body is a raw JSON Schema document.

curl -X PUT 'http://localhost:3333/api/kiwi/schemas/runbook' \
  -H "Content-Type: application/json" \
  -d '{
    "type": "object",
    "required": ["title", "status", "owner"],
    "properties": {
      "title": {"type": "string"},
      "status": {"type": "string", "enum": ["draft", "reviewed", "verified"]},
      "owner": {"type": "string"}
    }
  }'

When [schema] enforce = true, schema changes trigger a reload so subsequent writes use the updated schema immediately.

Last modified on May 4, 2026

REST API

CLI

List schema types

Get a schema

Create or update a schema

​List schema types

​Get a schema

​Create or update a schema

List schema types

Get a schema

Create or update a schema