Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.kiwifs.com/llms.txt

Use this file to discover all available pages before exploring further.

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