api-design - Design consistent REST APIs
Provides conventions for REST resource design, HTTP semantics, responses, pagination, filtering, authentication, rate limiting, and versioning.
Tags
Updated: 2026-09-28Capabilities
Typical Inputs
Typical Outputs
What this skill does
- Design resource URLs
- Choose HTTP methods
- Define status codes
- Structure response envelopes
- Select pagination strategies
- Specify filtering and sorting
- Plan authentication and authorization
- Recommend rate limits
- Plan API versioning
Inputs
- API requirements
- Existing API contracts
- Pagination requirements
- Filtering requirements
- Versioning requirements
- Authentication requirements
Outputs
- API design recommendations
- Endpoint conventions
- Response format specifications
- Pagination specifications
- Error response specifications
- Versioning recommendations