Admin API
Operational endpoints used by the admin UI and ops tooling: trigger or check reindex jobs, read usage / billing counters, flush in-process caches, peek at the LLM-config view. Separate from cfg because these are runtime / lifecycle controls rather than configuration data.
| Method | Path | Summary | Key params | Response |
|---|---|---|---|---|
| POST | /admin/cfg/reload | Force-reload config snapshot | — | VersionDto |
| GET | /admin/cfg/snapshot | Full config snapshot | — | SnapshotDto |
| GET | /admin/cfg/version | Config cache version | — | VersionDto |
| GET | /admin/dlus/backfill/autofill-candidates | List DLUs with missing autofill-derivable fields | — | (no body) |
| POST | /admin/dlus/backfill/event-relations-narrative | Backfill narrative-order event relations | — | (no body) |
| POST | /admin/dlus/create-book | Create a book-level DLU and re-parent its segments | body: CreateBookBody | (no body) |
| POST | /admin/reindex/flush | Manually flush the reindex queue | — | ReindexFlushResponse |
| GET | /admin/reindex/status | Current reindex queue status | — | ReindexStatus |
| GET | /admin/usage | Aggregated usage analytics rows | — | UsageRow[] |
Examples
Section titled “Examples”Reindex status
curl -H "X-API-Key: $API_KEY" "$ARCHAIC/admin/reindex/status"