AnomalyArmor OAuth API

openapi: 3.2.0
info:
  title: Anomalyarmor Ai OAuth API
  version: 1.0.0
  contact:
    name: AnomalyArmor Support
    url: https://anomalyarmor.ai/support
  license:
    name: Proprietary
  description: 'Operations tagged OAuth across 3 of this provider''s published API definitions: anomalyarmor.ai-openapi.json, app.anomalyarmor.ai-openapi.json, docs.anomalyarmor.ai-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: http://localhost:8000
  description: Development server
- url: https://api.anomalyarmor.ai
  description: Production server
tags:
- name: OAuth
paths:
  /api/v1/oauth/{provider_type}/authorize:
    get:
      tags:
      - OAuth
      summary: Oauth Authorize
      description: 'Initiate OAuth authorization flow.


        Returns the authorization URL for the frontend to redirect to.

        This is an authenticated endpoint (requires Bearer token), so the frontend

        must call it via API, then redirect the browser to the returned URL.


        Args:

        provider_type: Provider type (github, gitlab, bitbucket)

        provider_id: Git provider public ID

        ctx: Application context with session, user, and company info

        settings: Application settings


        Returns:

        StandardResponse with authorization_url for browser redirect


        Raises:

        HTTPException: If provider type not supported or credentials missing'
      operationId: oauth_authorize_api_v1_oauth__provider_type__authorize_get
      parameters:
      - name: provider_type
        in: path
        required: true
        schema:
          type: string
          title: Provider Type
      - name: provider_id
        in: query
        required: true
        schema:
          type: string
          description: Git provider public ID
          title: Provider Id
        description: Git provider public ID
      - name: Authorization
        in: header
        required: false
        schema:
          type: string
          title: Authorization
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StandardResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    servers:
    - url: http://localhost:8000
      description: Development server
    - url: https://api.anomalyarmor.ai
      description: Production server
  /api/v1/oauth/{provider_type}/callback:
    get:
      tags:
      - OAuth
      summary: Oauth Callback
      description: 'Handle OAuth callback and exchange code for token.


        Note: This endpoint does NOT use AppContext because it''s publicly accessible

        (called by OAuth provider redirect, not authenticated). User/company validation

        is done via CSRF state token stored during authorization initiation.


        Args:

        provider_type: Provider type (github, gitlab, bitbucket)

        code: Authorization code from OAuth provider

        state: CSRF state token

        session: Database session

        settings: Application settings


        Returns:

        Redirect to frontend with success/error


        Raises:

        HTTPException: If OAuth flow fails'
      operationId: oauth_callback_api_v1_oauth__provider_type__callback_get
      parameters:
      - name: provider_type
        in: path
        required: true
        schema:
          type: string
          title: Provider Type
      - name: code
        in: query
        required: true
        schema:
          type: string
          description: OAuth authorization code
          title: Code
        description: OAuth authorization code
      - name: state
        in: query
        required: true
        schema:
          type: string
          description: CSRF state token
          title: State
        description: CSRF state token
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    servers:
    - url: http://localhost:8000
      description: Development server
    - url: https://api.anomalyarmor.ai
      description: Production server
components:
  schemas:
    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
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    StandardResponse:
      properties:
        success:
          type: boolean
          title: Success
        data:
          anyOf:
          - {}
          - type: 'null'
          title: Data
        message:
          anyOf:
          - type: string
          - type: 'null'
          title: Message
        error:
          anyOf:
          - type: string
          - type: 'null'
          title: Error
        meta:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          title: Meta
      type: object
      required:
      - success
      title: StandardResponse
      description: Standard API response wrapper.
x-refined-from:
- anomalyarmor.ai-openapi.json
- app.anomalyarmor.ai-openapi.json
- docs.anomalyarmor.ai-openapi.json