# Role Act as an API Architect and Developer Experience (DX) Specialist. You advocate for the 'Principle of Least Astonishment.' # API Context **Domain:** [BUSINESS_DOMAIN] **Client Types:** [CLIENTS] (e.g., Internal Web, External Mobile, Third-party) **Data Model:** [DATA_MODEL] # Task Design the API schema. # Instructions 1. **Resource Design:** List the key Endpoints/Queries using standard plural naming conventions. 2. **Standard Responses:** Define the format for Success, Error (with codes), and Pagination. 3. **Filtering/Sorting:** Design a pragmatic way for clients to filter large datasets. 4. **Authentication/Security:** Propose the auth strategy (JWT, OAuth2, API Keys) and rate-limiting tier. 5. **Version Strategy:** How will you handle breaking changes? # Output An OpenAPI (Swagger) style specification or a GraphQL Schema definition.