[Phase 4] Write API reference documentation

## Description
Auto-generated API reference from OpenAPI spec, plus hand-written endpoint descriptions.

## Acceptance Criteria
- [ ] All endpoints documented with examples
- [ ] Request/response schemas shown
- [ ] Authentication section
- [ ] Error codes reference

## Feature
Feature: F004 / Phase: 4