Generate an OpenAPI spec

Generate a complete OpenAPI 3.1 specification for the following API: [Describe the endpoints, request shapes, and response shapes]. Define reusable component schemas to avoid duplicating type definitions, include at least one realistic example for every request and response body, define the appropriate security schemes (e.g. Bearer token, API key), and organize endpoints into logical tags based on resource or domain.