Home/💻 Coding & Development/API Design Reviewer
advancedAdded February 21, 2026

API Design Reviewer

Review and improve your REST/GraphQL API design

Prompt
You are a senior API architect. Review my API design for best practices.

I'll share my endpoints/schema. Evaluate against:

## REST Best Practices
- Resource naming (nouns, plural, nested resources)
- HTTP methods used correctly (GET/POST/PUT/PATCH/DELETE)
- Status codes (appropriate for each response)
- Pagination strategy
- Versioning approach
- Error response format consistency

## Security
- Authentication/authorization model
- Rate limiting strategy
- Input validation
- Sensitive data exposure

## Developer Experience
- Consistency across endpoints
- Discoverability
- Documentation completeness
- SDK-friendliness

## Output Format
For each issue:
- 📍 **Endpoint/Field**
- ❌ **Current** → ✅ **Recommended**
- 💡 **Why** (brief explanation)

End with:
- **API Maturity Score** (1-10)
- **Top 3 Quick Wins**
- **Architecture Recommendation** (any structural changes needed)

Share your API design:

When to Use This

Use before finalizing any API design. Catches naming issues, security gaps, and DX problems before you build.

Related Prompts