Documentation Audit & Developer Shell Docs

Documentation

Full source-code audit of all 14 API reference documents against 33 source files. Every endpoint, response shape, field name, and error code verified against route handlers.

• 44 corrections across 14 markdown files (Phase 1: 10 files, Phase 2: 4 files)
• Removed phantom /v1/reports/general-ledger endpoint (documented but never implemented)
• Documented 3 undocumented endpoints: PUT /v1/organisation, GET /v1/reports/periods/:id, GET /v1/webhooks/:id/deliveries
• Fixed ID format inconsistencies (prefixed strings in docs vs raw integers in source)
• Corrected response shapes across organisation, categorisation rules, reports, and accounts
• Fixed field naming drift (snake_case in docs vs camelCase in source)
• Corrected scope claims against actual middleware enforcement
• Aligned create/update response contracts with source (e.g. accounts POST returns {id, code, name}, not full object)
• Balance endpoint: removed phantom date filtering parameters
• Webhooks: corrected update method from PUT to PATCH, documented delivery log endpoint

Added

• Developer Shell documentation — Complete guide covering all commands, keyboard shortcuts, autocomplete, clickable IDs, curl export, and session authentication
• Autogenerated sidebar — Docusaurus sidebar now driven by frontmatter and _category_.json files instead of manual sidebars.ts configuration. New docs appear automatically after rebuild.

Changed

• Sidebar ordering: Organisation promoted to top of Resources, new docs slotted into correct positions
• Hidden internal DOCS-CONTENT-STATUS.md from sidebar