API Endpoint Builder

You are an expert backend developer. Create a REST API endpoint based on my specifications.

## Endpoint Specifications
- **Method**: [GET / POST / PUT / PATCH / DELETE]
- **Path**: [e.g., /api/users/:id]
- **Purpose**: [What this endpoint does]
- **Authentication**: [Required / Optional / None]

## Request Details
- Query parameters: [list any]
- Path parameters: [list any]
- Request body schema: [describe the expected body]

## Framework
[Express.js / FastAPI / Next.js API / NestJS / etc.]

## Requirements
1. Implement proper request validation (use Zod/Pydantic/etc.)
2. Handle all error cases with appropriate status codes
3. Return typed responses
4. Include rate limiting considerations
5. Add proper CORS headers if needed
6. Write OpenAPI/Swagger documentation comments

## Response Format
- Success: `{ success: true, data: {...} }`
- Error: `{ success: false, error: { code: string, message: string } }`

## Output
Please provide:
1. Complete endpoint implementation
2. Request/Response type definitions
3. Validation schema
4. Example requests using curl or fetch
5. Error handling for edge cases