dialogbrain-com OAuth API

openapi: 3.2.0
info:
  title: DialogBrain v2 API Gateway OAuth API
  description: Clean refactored API gateway with minimal vertical slice
  version: 0.1.0
tags:
- name: OAuth
paths:
  /api/oauth/google/callback:
    get:
      tags:
      - OAuth
      summary: Google Oauth Callback
      description: 'Universal OAuth callback endpoint for Google services (Calendar, Gmail).


        Google redirects here after user authorizes (or denies) access.

        This endpoint:

        1. Determines service type by checking Redis state prefixes

        2. Exchanges the code for tokens

        3. Creates/updates the channel_account

        4. Saves OAuth tokens

        5. Redirects to frontend with success/error status


        Args:

        code: Authorization code from Google

        state: State token for CSRF protection

        error: Error code if user denied access

        error_description: Human-readable error description


        Returns:

        Redirect to frontend integrations page with status'
      operationId: google_oauth_callback_api_oauth_google_callback_get
      parameters:
      - name: code
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Code
      - name: state
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: State
      - name: error
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Error
      - name: error_description
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Error Description
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/oauth/google/status:
    get:
      tags:
      - OAuth
      summary: Google Oauth Status
      description: 'Check OAuth status for a Google Calendar account.


        Args:

        account_id: Channel account ID


        Returns:

        Account status and token expiration info'
      operationId: google_oauth_status_api_oauth_google_status_get
      parameters:
      - name: account_id
        in: query
        required: true
        schema:
          type: integer
          description: Account ID to check
          title: Account Id
        description: Account ID to check
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/oauth/google/sync-calendars:
    post:
      tags:
      - OAuth
      summary: Sync Google Calendars
      description: 'Manually sync Google Calendar calendars as threads.


        This endpoint fetches all calendars from Google Calendar and persists them

        as Thread entries in the database, so they appear in the Unified Inbox.


        Args:

        account_id: Channel account ID


        Returns:

        Number of calendars synced'
      operationId: sync_google_calendars_api_oauth_google_sync_calendars_post
      parameters:
      - name: account_id
        in: query
        required: true
        schema:
          type: integer
          description: Account ID to sync calendars for
          title: Account Id
        description: Account ID to sync calendars for
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/oauth/gmail/status:
    get:
      tags:
      - OAuth
      summary: Gmail Oauth Status
      description: 'Check OAuth status for a Gmail account.


        Args:

        account_id: Channel account ID


        Returns:

        Account status and token expiration info'
      operationId: gmail_oauth_status_api_oauth_gmail_status_get
      parameters:
      - name: account_id
        in: query
        required: true
        schema:
          type: integer
          description: Account ID to check
          title: Account Id
        description: Account ID to check
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/oauth/microsoft/callback:
    get:
      tags:
      - OAuth
      summary: Microsoft Oauth Callback
      description: 'Microsoft redirects here after a person signs in to connect a channel on

        the platform''s Entra app (Teams, Outlook calendar), or after an

        administrator consents for the tenant. The state names the channel; a

        state minted before it did is Teams.


        A sign-in the tenant''s policy refuses for want of an admin''s consent

        (AADSTS65001 and friends) is answered with the admin-consent link to

        forward, not as a failure.'
      operationId: microsoft_oauth_callback_api_oauth_microsoft_callback_get
      parameters:
      - name: code
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Code
      - name: state
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: State
      - name: error
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Error
      - name: error_description
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Error Description
      - name: admin_consent
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Admin Consent
      - name: tenant
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Tenant
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    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
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError