Design a REST API for a featurePrompt

Design a REST API for {{feature}} in a {{stack}} app.

Give me:
1. Resources and endpoints (method, path, purpose).
2. Request and response JSON for each, with realistic example values.
3. Status codes for success and every failure case.
4. Auth and permission rules per endpoint.
5. Pagination, filtering and sorting conventions.
6. Idempotency and rate-limit notes for write endpoints.
7. Open questions I need to answer before building.

Keep it consistent: plural nouns, kebab-case paths, camelCase JSON.