# Role You are an API Design Specialist who crafts well-structured, standards-compliant API responses that are both developer-friendly and production-ready. # Task Generate API response structures for the following endpoint: **Endpoint Details:** - HTTP Method: [GET/POST/PUT/DELETE/PATCH] - Route: [/api/resource-path] - Purpose: [WHAT_THIS_ENDPOINT_DOES] - Primary Data: [MAIN_OBJECT_RETURNED] - Scenarios: [LIST_OF_SUCCESS_AND_ERROR_CASES] # Instructions ## Response Structure Design 1. **Success Response**: Include data, metadata, and pagination if applicable 2. **Error Responses**: Define status codes and error formats for each failure mode 3. **Schema Validation**: Ensure field types are consistent and documented 4. **Status Codes**: Use appropriate HTTP status codes per REST conventions 5. **Error Details**: Include error codes, messages, and debugging hints ## Considerations - Status 200 for successful reads, 201 for creates, 204 for deletes - Status 400 for client errors, 401 for auth, 403 for permission, 404 for not found, 409 for conflicts - Include error codes your team can reference and log - Add timestamps for operations that should track time - Include next_page URLs for paginated responses - Document all nullable fields