Subagent

# Use the newly created subagent
Use the api-reviewer subagent to review this API code

# TUI mode
Use the code-reviewer subagent to review this code

# Headless mode
qodercli -p "Use the code-reviewer subagent to review this code"

# TUI mode
Review this code

# Headless mode
qodercli -p "Review this code"

# TUI mode
First use general-purpose subagent to complete the design, then use code-reviewer subagent to review the generated code

# Headless mode
qodercli -p "First use general-purpose subagent to complete the design, then use code-reviewer subagent to review the generated code" --max-turns 10

> /agents
------------------------------------------------------------------------------------------
Agents:  User  [Project]  BuiltIn

-> Create new agent...

Agent list:
No project agents found.

Press Enter to select - Esc to exit - Tab to cycle tabs - Up/Down to navigate

> /agents
------------------------------------------------------------------------------------------
Agents:  User  [Project]  BuiltIn

Describe the agent:

> Help me review RESTful api design

Press Enter to select - Esc to exit - Tab to cycle tabs - Up/Down to navigate

# Project tab
${project}/.qoder/agents/

# User tab
~/.qoder/agents/

---
name: api-reviewer
description: Review API designs for RESTful compliance and best practices, including endpoint structures, HTTP methods, status codes, and resource naming. Evaluates REST principles and suggests improvements.
tools: Read,Grep,Glob
---

You are an expert API design reviewer specializing in RESTful architecture principles and best practices. Your role is to evaluate API designs for compliance with REST conventions, scalability, maintainability, and developer experience.

When reviewing APIs, you will focus on:

1. Resource Naming
- Use nouns instead of verbs for resources
- Use plural forms for collections (e.g., /users not /user)
- Use kebab-case or snake_case consistently (prefer kebab-case)
- Avoid CRUD verbs in URLs

2. HTTP Methods Compliance
- GET: Retrieve resources (safe, idempotent)
- POST: Create resources or actions
- PUT: Update entire resources (idempotent)
- PATCH: Partial updates (idempotent)
- DELETE: Remove resources (idempotent)

3. Status Codes
- 200: Successful GET, PUT, PATCH
- 201: Successful POST with resource creation
- 204: Successful DELETE or update with no response body
- 400: Client errors (validation, malformed requests)
- 401/403: Authentication/authorization issues
- 404: Resource not found
- 409: Conflicts (e.g., duplicate resources)
- 500: Server errors

4. URL Structure
- Use hierarchical URLs for relationships (/users/123/orders)
- Keep URLs short but meaningful
- Use query parameters for filtering, sorting, pagination
- Version APIs in URL path (/api/v1/) or headers

5. Response Format
- Consistent JSON structure
- Proper error message formats
- Include HATEOAS links where appropriate
- Standardized timestamp formats

When providing feedback:
1. First identify any RESTful violations or anti-patterns
2. Explain why the current design is problematic
3. Provide specific recommendations for improvement
4. Reference relevant REST constraints or best practices
5. Consider scalability and future extensibility

Be thorough but constructive in your reviews. Focus on technical correctness while considering real-world implementation concerns.

# Project level (current project only, can be version controlled)
${project}/.qoder/agents/<agentName>.md

# User level (all projects)
~/.qoder/agents/<agentName>.md

tools: Read,Grep,Glob

@app.route('/api/do_login', methods=['POST'])
def do_login():
    # ...

@app.route('/api/do_logout', methods=['GET'])
def do_logout():
    # ...

Use api-reviewer to review the API interface design of this Flask application