API Design

Purpose

Design REST/RPC endpoint contracts with request/response types, error handling, and versioning strategy. Produces TypeScript type definitions and endpoint documentation that serve as the contract between frontend and backend.

Scope Constraints

• Produces endpoint contracts and type definitions only; does not implement route handlers.
• Covers endpoint specification, request/response types, error contracts, pagination, and caching.
• Does not design database schemas or run codebase analysis — hand off to schema-design or codebase-context.

Inputs

• Feature requirements (from interview/idea phase)
• Schema design output (entities, relationships — drives endpoint shape)
• Existing endpoints (current route handlers, naming conventions)
• Authentication/authorization model (who can call what)