Bolrach Wiki API reference

Public read

GET /v1/wiki/articles

List published articles (optional limit).

curl "https://api.bolrach.dev/v1/wiki/articles?limit=20" \
  -H "Accept: application/json"

GET /v1/wiki/articles/{slug}

Published article body blocks, current version, and linked claims when an entity is bound.

curl "https://api.bolrach.dev/v1/wiki/articles/hello-world" \
  -H "Accept: application/json"

GET /v1/wiki/sources/{id}

Source metadata and recent snapshots (content hash, storage key, locator).

Authenticated write

Pass Authorization: Bearer bt_... with wiki:write. Drafts start as status=draft; set published to appear on bolrach.wiki.

POST /v1/wiki/articles

curl -X POST "https://api.bolrach.dev/v1/wiki/articles" \
  -H "Authorization: Bearer bt_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"slug":"my-topic","title":"My topic","body":{"blocks":[{"type":"p","text":"Hello"}]}}'

PUT /v1/wiki/articles/{id}

New version: optional title, body, status ( draft|review|published|withdrawn), change_summary.

curl -X PUT "https://api.bolrach.dev/v1/wiki/articles/ARTICLE_ID" \
  -H "Authorization: Bearer bt_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"status":"published","change_summary":"first publish"}'

GET /v1/wiki/admin/articles

Author list (wiki:write). Optional status=draft|review|published|withdrawn and limit.

curl "https://api.bolrach.dev/v1/wiki/admin/articles?status=draft" \
  -H "Authorization: Bearer bt_your_key_here"

DELETE /v1/wiki/articles/{id}

Remove a draft or withdrawn article only. Published articles must be withdrawn first (409 otherwise).

curl -X DELETE "https://api.bolrach.dev/v1/wiki/articles/ARTICLE_ID" \
  -H "Authorization: Bearer bt_your_key_here"

GET /v1/wiki/admin/articles/{id}/versions

Author version history (wiki:write). Newest first; optional limit.

curl "https://api.bolrach.dev/v1/wiki/admin/articles/ARTICLE_ID/versions?limit=20" \
  -H "Authorization: Bearer bt_your_key_here"

GET /v1/wiki/admin/articles/{id}/versions/{versionId}

Fetch one version body for author preview before restore (wiki:write).

curl "https://api.bolrach.dev/v1/wiki/admin/articles/ARTICLE_ID/versions/VERSION_ID" 
  -H "Authorization: Bearer bt_your_key_here"

POST /v1/wiki/admin/articles/{id}/versions/{versionId}/restore

Restore a prior version (wiki:write). Copies title/body into a new version so the audit trail stays intact.

curl -X POST "https://api.bolrach.dev/v1/wiki/admin/articles/ARTICLE_ID/versions/VERSION_ID/restore" 
  -H "Authorization: Bearer bt_your_key_here"

POST /v1/wiki/sources · /sources/{id}/snapshots · /claims · /entities

Provenance plane: register sources, capture snapshots (hash + storage_key), attach claims to entities.

Reader

bolrach.wiki lists published articles (client filter by title/slug) and renders path routes /{slug} with claim panels when present.