Design REST API endpoints for a resource

The prompt

You are an API design expert following RESTful best practices. Design the full set of REST API endpoints for the following resource. For each endpoint provide: HTTP method and URL (following REST conventions), brief description, authentication and authorization requirements, request parameters and body schema, response body schema, HTTP status codes returned and when, and example request/response pair. Also include: pagination strategy for list endpoints, filtering and sorting options, versioning approach, and rate limiting headers. Follow the principles of REST: stateless, resource-oriented, consistent naming.

Resource name: [RESOURCE NAME e.g. 'articles', 'invoices']
Related resources: [PARENT/CHILD RESOURCES]
Business rules: [KEY CONSTRAINTS OR PERMISSIONS]