Bellator Schedule Intelligence Feedback API

openapi: 3.2.0
info:
  title: Bellator Schedule Intelligence Feedback API
  description: 'Bellator Schedule Intelligence APIs - Stateless Schedule Health APIs


    ## Features


    * **Schedule Analysis** - Comprehensive schedule health analysis

    * **Critical Path** - CPM-based critical path calculation

    * **Validation** - Schedule validation and quality checks

    * **Future: Resource Management** - Resource allocation and leveling

    * **Future: Simulation** - Monte Carlo and what-if analysis

    * **Future: AI Recommendations** - LLM-powered optimization suggestions


    ## Authentication


    API key authentication via `x-api-key` header or OAuth 2.0 Bearer token via `Authorization` header.


    ### API Key Authentication (Legacy)

    Include API key in `x-api-key` header.


    ### OAuth 2.0 / Azure AD Authentication (Recommended)

    Include Bearer token in `Authorization` header: `Authorization: Bearer `


    Tiers:

    - **Free**: 2,000 tasks, 100 req/min, 5MB payload

    - **Professional**: 5,000 tasks, 500 req/min, 25MB payload

    - **Enterprise**: 50,000 tasks, 2,000 req/min, 100MB payload

    - **Government**: 100,000+ tasks, 10,000 req/min, 500MB payload


    ## Usage Metering


    All API requests are metered and tracked for:

    - Request duration (milliseconds)

    - Task count processed

    - Token consumption (for LLM operations)

    - Estimated cost (USD)


    Metering events are emitted to logs and can be integrated with billing systems.


    ## Security


    * Tier-based task limits (500-100,000 tasks per request)

    * Tier-based payload limits (5-500 MB)

    * Input validation and sanitization

    * Tier-based rate limiting (100-10,000 requests per 60 seconds)'
  version: 0.4.0
tags:
- name: Feedback
paths:
  /api/v1/feedback:
    post:
      tags:
      - Feedback
      summary: Submit playground feedback
      description: 'Submit authenticated playground feedback through the shared communications pipeline.


        This endpoint exists for frontend compatibility and normalizes payloads into

        the same contact submission system used by contact and waitlist forms.'
      operationId: submit_playground_feedback_api_v1_feedback_post
      parameters:
      - name: Authorization
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Authorization
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PlaygroundFeedbackRequest'
      responses:
        '201':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ContactSubmissionResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/v1/feedback/page:
    post:
      tags:
      - Feedback
      summary: Submit docs page helpfulness feedback
      description: 'Submit lightweight yes/no docs feedback through the shared communications pipeline.


        This channel persists feedback for product analytics and sends support

        notifications for operational visibility.'
      operationId: submit_page_feedback_api_v1_feedback_page_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PageFeedbackRequest'
        required: true
      responses:
        '201':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ContactSubmissionResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    ContactSubmissionResponse:
      properties:
        submission_id:
          type: string
          title: Submission Id
          description: Unique submission ID for tracking
        status:
          type: string
          title: Status
          description: Submission status
          default: success
        message:
          type: string
          title: Message
          description: Success message confirming submission was received
        expected_response_time_hours:
          anyOf:
          - type: integer
          - type: 'null'
          title: Expected Response Time Hours
          description: Deprecated optional field. Contact submissions do not promise a response-time SLA.
      type: object
      required:
      - submission_id
      - message
      title: ContactSubmissionResponse
      description: Response schema for successful contact form submission.
    PlaygroundFeedbackRequest:
      properties:
        email:
          type: string
          maxLength: 255
          minLength: 5
          title: Email
          description: Submitter email
        category:
          type: string
          enum:
          - bug
          - feature
          - question
          - other
          title: Category
          description: Feedback category
          default: other
        feedback:
          type: string
          maxLength: 5000
          minLength: 1
          title: Feedback
          description: Feedback message
        source:
          type: string
          maxLength: 100
          title: Source
          description: Source page identifier
          default: playground
      type: object
      required:
      - email
      - feedback
      title: PlaygroundFeedbackRequest
      description: Request schema for playground feedback endpoint.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    PageFeedbackRequest:
      properties:
        response:
          type: string
          enum:
          - 'yes'
          - 'no'
          title: Response
          description: Helpfulness response
        page_path:
          type: string
          maxLength: 255
          minLength: 1
          title: Page Path
          description: Page path
        source:
          type: string
          maxLength: 100
          title: Source
          description: Source identifier
          default: docs_page
      type: object
      required:
      - response
      - page_path
      title: PageFeedbackRequest
      description: Request schema for docs page helpfulness feedback.
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: API key for authentication. Required when API_KEY is configured.
    OAuth2:
      type: oauth2
      flows:
        authorizationCode:
          authorizationUrl: https://login.microsoftonline.com/{tenant}/oauth2/v2.0/authorize
          tokenUrl: https://login.microsoftonline.com/{tenant}/oauth2/v2.0/token
          scopes:
            api.read: Read access to API
            api.write: Write access to API
      description: OAuth 2.0 / Azure AD authentication (recommended)
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: JWT Bearer token from OAuth 2.0 / Azure AD