### {{METHOD}} {{path}}

- **Auth**: {{required role / token / public}}
- **Permissions**: {{capability checks}}
- **Request**: {{schema reference or inline shape}}
- **Response**: {{status → schema reference or inline shape}}
- **Errors**: {{code → cross-link to error-codes.md}}
- **Rate limit**: {{tier or "inherits module default"}}
- **Notes**: {{versioning, deprecation, idempotency}}