engineer-api-design - Professional REST API Design Architecture
Designs, creates, reviews, and documents consistent, secure, and well-structured REST API endpoints and schemas.
Tags
Updated: 2026-09-19Capabilities
Typical Inputs
Typical Outputs
What this skill does
- Define domain resources
- Map HTTP methods to operations
- Design request and response schemas
- Structure RESTful resource URLs
- Implement idempotent request handling
- Generate OpenAPI documentation
Inputs
- API requirements and specifications
- Schema and infrastructure reference files
- Idempotency key headers
Outputs
- Standardized HTTP JSON response envelopes
- Zod request and response schemas
- OpenAPI documentation
- Serverless function route handlers
Requirements
- Serverless or HTTP server runtime
- Zod schema validation library