# REST & API Route Design Patterns

> API design guidelines covering request validation, standardized error envelopes, cursor-based pagination, and HTTP status code discipline.

Canonical: https://www.agentickit.co/skills/api-patterns
Last updated: 2026-11-18

## Key practices
- Validate every incoming request payload using strict Zod schemas
- Return standardized JSON error objects: { error: { code, message, details } }
- Use cursor-based pagination instead of offset pagination for large datasets
- Enforce explicit HTTP method routing and CORS origin whitelisting

## Related
- [api-engineer](https://www.agentickit.co/agents/api-engineer)
- [tech-lead](https://www.agentickit.co/agents/tech-lead)
- [backend-architect](https://www.agentickit.co/agents/backend-architect)
- [/build-api](https://www.agentickit.co/commands/build-api)
- [/write-docs](https://www.agentickit.co/commands/write-docs)
