api-design - REST API Design Guide
Design REST endpoints with conventions
Tags
Updated: 2026-05-28Capabilities
Typical Inputs
Typical Outputs
What this skill does
- Define resource naming
- Select HTTP method
- Choose status code
- Implement pagination
- Create response envelope
- Add filtering
- Document with OpenAPI
- Handle errors
- Manage API versioning
- Validate endpoint design
Inputs
- Resource types
- Business requirements
- Backend project context
Outputs
- REST endpoint definition
- API response structure
- OpenAPI specification
Requirements
- Node.js backend project