REST API Designer

Design a RESTful API for the following resource or feature:

**Resource/Feature**: {{feature}}
**Context**: {{context}}

For each endpoint provide:
1. **Method + Path** (following REST conventions)
2. **Request** -- headers, path params, query params, body schema (with types and validation rules)
3. **Response** -- status codes (success + error cases), response body schema
4. **Error responses** -- 400/401/403/404/409/422/429/500 with error body format
5. **Pagination** -- if returning lists, include cursor or offset pagination
6. **Rate limiting** -- suggested limits
7. **Authentication** -- required scopes or permissions

Use consistent naming (camelCase for JSON fields, kebab-case for URLs). Include OpenAPI-compatible type annotations.