components:
  responses:
    Ok:
      description: Successful response
      content:
        application/json:
          schema:
            $ref: ./response.yaml#/components/schemas/BaseResponse

    Created:
      description: Resource created
      content:
        application/json:
          schema:
            $ref: ./response.yaml#/components/schemas/BaseResponse

    Accepted:
      description: Request accepted for processing
      content:
        application/json:
          schema:
            $ref: ./response.yaml#/components/schemas/BaseResponse

    BadRequest:
      description: Bad request payload or query/path parameter
      content:
        application/json:
          schema:
            $ref: ./response.yaml#/components/schemas/ErrorResponse

    Unauthorized:
      description: Unauthorized
      content:
        application/json:
          schema:
            $ref: ./response.yaml#/components/schemas/ErrorResponse

    Forbidden:
      description: Forbidden
      content:
        application/json:
          schema:
            $ref: ./response.yaml#/components/schemas/ErrorResponse

    NotFound:
      description: Resource not found
      content:
        application/json:
          schema:
            $ref: ./response.yaml#/components/schemas/ErrorResponse

    Gone:
      description: Resource is no longer available
      content:
        application/json:
          schema:
            $ref: ./response.yaml#/components/schemas/ErrorResponse

    Conflict:
      description: Conflict
      content:
        application/json:
          schema:
            $ref: ./response.yaml#/components/schemas/ErrorResponse

    TooManyRequests:
      description: Too many requests
      content:
        application/json:
          schema:
            $ref: ./response.yaml#/components/schemas/ErrorResponse

    InternalServerError:
      description: Internal server error
      content:
        application/json:
          schema:
            $ref: ./response.yaml#/components/schemas/ErrorResponse