Sarj AI Developer API Reports API

openapi: 3.2.0
info:
  title: Sarj.ai Voice Reports API
  version: 1.0.0
tags:
- name: Reports
paths:
  /v1/beta/reports/list:
    post:
      tags:
      - Reports
      summary: List Reports
      operationId: reportsListReports
      parameters:
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          maximum: 100
          minimum: 1
          default: 20
          title: Limit
      - name: cursor
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Cursor
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TaskPagination'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/beta/reports/{task_id}/download:
    get:
      tags:
      - Reports
      summary: Download Report
      operationId: reportsDownloadReport
      parameters:
      - name: task_id
        in: path
        required: true
        schema:
          type: string
          title: Task Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DownloadResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    OpenAITTSSettings:
      properties:
        provider:
          type: string
          const: openai
          title: Provider
        model:
          $ref: '#/components/schemas/OpenAITTSModels'
          default: gpt-4o-mini-tts
        voice:
          $ref: '#/components/schemas/OpenAITTSVoices'
          default: ash
        speed:
          type: number
          maximum: 4.0
          minimum: 0.25
          title: Speed
          description: Speech speed (0.25-4.0)
          default: 1.0
        instructions:
          anyOf:
          - type: string
          - type: 'null'
          title: Instructions
      type: object
      required:
      - provider
      title: OpenAITTSSettings
    UpdateScenarioAgentMessage:
      properties:
        type:
          type: string
          const: update_scenario_agent
          title: Type
          default: update_scenario_agent
        organization_id:
          type: string
          title: Organization Id
        deleted_agent_id:
          type: string
          title: Deleted Agent Id
        language:
          type: string
          title: Language
      type: object
      required:
      - organization_id
      - deleted_agent_id
      - language
      title: UpdateScenarioAgentMessage
    CartesiaModels:
      type: string
      enum:
      - sonic-3
      - sonic-2
      - sonic
      title: CartesiaModels
    OrpheusArabicVoice:
      type: string
      enum:
      - fahad
      - sultan
      - lulwa
      - noura
      - aisha
      - abdullah
      title: OrpheusArabicVoice
    CreateBatchCallsMessage:
      properties:
        type:
          type: string
          const: create_batch_calls
          title: Type
          default: create_batch_calls
        batch_id:
          type: string
          title: Batch Id
      type: object
      required:
      - batch_id
      title: CreateBatchCallsMessage
    Task:
      properties:
        id:
          type: string
          title: Id
        organization_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Organization Id
        user_id:
          anyOf:
          - type: string
          - type: 'null'
          title: User Id
        call_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Call Id
        batch_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Batch Id
        type:
          $ref: '#/components/schemas/TaskType'
        status:
          $ref: '#/components/schemas/TaskStatus'
        status_changed_at:
          type: string
          format: date-time
          title: Status Changed At
        message:
          oneOf:
          - $ref: '#/components/schemas/EnhancedTranscriptionMessage'
          - $ref: '#/components/schemas/CallOutcomeMessage'
          - $ref: '#/components/schemas/ScenarioInsightAnalysisMessage'
          - $ref: '#/components/schemas/BatchReportGenerationMessage'
          - $ref: '#/components/schemas/CreateBatchCallsMessage'
          - $ref: '#/components/schemas/BatchCallsRetryMessage'
          - $ref: '#/components/schemas/StartBatchCallsTickMessage'
          - $ref: '#/components/schemas/DeleteOldTasksTickMessage'
          - $ref: '#/components/schemas/OutboundDispatchTickMessage'
          - $ref: '#/components/schemas/DeleteExpiredOrgDataTickMessage'
          - $ref: '#/components/schemas/WebhookNotificationMessage'
          - $ref: '#/components/schemas/ZohoCRMRecordUpdateMessage'
          - $ref: '#/components/schemas/ZohoCallActivityMessage'
          - $ref: '#/components/schemas/StaleCallCleanupMessage'
          - $ref: '#/components/schemas/CallQueuedHealthCheckMessage'
          - $ref: '#/components/schemas/CallInProgressHealthCheckMessage'
          - $ref: '#/components/schemas/CallRetryMessage'
          - $ref: '#/components/schemas/VoiceMigrationMessage'
          - $ref: '#/components/schemas/CallReportsEnqueueMessage'
          - $ref: '#/components/schemas/ScenarioGenerationMessage'
          - $ref: '#/components/schemas/ProcessMessagingMessage'
          - $ref: '#/components/schemas/CreateDefaultAgentsMessage'
          - $ref: '#/components/schemas/UpdateScenarioAgentMessage'
          - $ref: '#/components/schemas/SlackAlertMessage'
          - $ref: '#/components/schemas/ConversationExportMessage'
          - $ref: '#/components/schemas/DispatchOutboundCallMessage'
          - $ref: '#/components/schemas/NoOpMessage'
          title: Message
          discriminator:
            propertyName: type
            mapping:
              batch_calls_retry: '#/components/schemas/BatchCallsRetryMessage'
              batch_report_generation: '#/components/schemas/BatchReportGenerationMessage'
              call_in_progress_health_check: '#/components/schemas/CallInProgressHealthCheckMessage'
              call_outcome: '#/components/schemas/CallOutcomeMessage'
              call_queued_health_check: '#/components/schemas/CallQueuedHealthCheckMessage'
              call_reports_enqueue: '#/components/schemas/CallReportsEnqueueMessage'
              call_retry: '#/components/schemas/CallRetryMessage'
              conversation_export: '#/components/schemas/ConversationExportMessage'
              create_batch_calls: '#/components/schemas/CreateBatchCallsMessage'
              create_default_agents: '#/components/schemas/CreateDefaultAgentsMessage'
              delete_expired_org_data_tick: '#/components/schemas/DeleteExpiredOrgDataTickMessage'
              delete_old_tasks_tick: '#/components/schemas/DeleteOldTasksTickMessage'
              dispatch_outbound_call: '#/components/schemas/DispatchOutboundCallMessage'
              enhanced_transcription: '#/components/schemas/EnhancedTranscriptionMessage'
              no_op: '#/components/schemas/NoOpMessage'
              outbound_dispatch_tick: '#/components/schemas/OutboundDispatchTickMessage'
              process_messaging_message: '#/components/schemas/ProcessMessagingMessage'
              scenario_generation: '#/components/schemas/ScenarioGenerationMessage'
              scenario_insight_analysis: '#/components/schemas/ScenarioInsightAnalysisMessage'
              slack_alert: '#/components/schemas/SlackAlertMessage'
              stale_call_cleanup: '#/components/schemas/StaleCallCleanupMessage'
              start_batch_calls_tick: '#/components/schemas/StartBatchCallsTickMessage'
              update_scenario_agent: '#/components/schemas/UpdateScenarioAgentMessage'
              voice_migration: '#/components/schemas/VoiceMigrationMessage'
              webhook_notification: '#/components/schemas/WebhookNotificationMessage'
              zoho_call_activity: '#/components/schemas/ZohoCallActivityMessage'
              zoho_crm_record_update: '#/components/schemas/ZohoCRMRecordUpdateMessage'
        created_at:
          type: string
          format: date-time
          title: Created At
        updated_at:
          type: string
          format: date-time
          title: Updated At
      type: object
      required:
      - id
      - type
      - status
      - status_changed_at
      - message
      - created_at
      - updated_at
      title: Task
    CallQueuedHealthCheckMessage:
      properties:
        type:
          type: string
          const: call_queued_health_check
          title: Type
          default: call_queued_health_check
        call_id:
          type: string
          title: Call Id
      type: object
      required:
      - call_id
      title: CallQueuedHealthCheckMessage
    DeepgramTTSModel:
      type: string
      enum:
      - aura-2
      title: DeepgramTTSModel
    BackchannelAudioConfig:
      properties:
        sound_id:
          $ref: '#/components/schemas/SoundId'
        volume:
          type: number
          maximum: 1.0
          minimum: 0.0
          title: Volume
          default: 1.0
        probability:
          type: number
          maximum: 1.0
          minimum: 0.0
          title: Probability
          default: 1.0
      type: object
      required:
      - sound_id
      title: BackchannelAudioConfig
    CallReportsEnqueueMessage:
      properties:
        type:
          type: string
          const: call_reports_enqueue
          title: Type
          default: call_reports_enqueue
      type: object
      title: CallReportsEnqueueMessage
    DeleteOldTasksTickMessage:
      properties:
        type:
          type: string
          const: delete_old_tasks_tick
          title: Type
          default: delete_old_tasks_tick
        tick_id:
          type: string
          title: Tick Id
      type: object
      title: DeleteOldTasksTickMessage
    TimeoutSettings:
      properties:
        type:
          type: string
          const: enabled
          title: Type
          default: enabled
        duration:
          anyOf:
          - type: string
            format: duration
          - type: integer
          title: Duration
          default: 15
        max_retries:
          type: integer
          title: Max Retries
          default: 5
      type: object
      title: TimeoutSettings
    HamsaTTSSpeaker:
      type: string
      enum:
      - Hiba
      - Khadija
      - Jasem
      - Fahd
      - Salma
      - Noor
      - Lana
      - Fatma
      - Mariam
      - Nada
      - Samir
      - Dalal
      - Mais
      - Alia
      - Faiza
      - Dima
      - Lyali
      - Carla
      - Hind
      - Safa
      - Somaya
      - Ali
      - Ahmed
      - Mazen
      - Majd
      - Amjad
      - Layan
      - Talin
      - Rema
      - Rami
      - Hamdan
      - Maher
      - Majid
      - Mansour
      - Hasan
      - Sayed
      title: HamsaTTSSpeaker
    OpenAILLMSettings:
      properties:
        provider:
          type: string
          const: openai
          title: Provider
        region:
          type: string
          const: default
          title: Region
          default: default
        model:
          $ref: '#/components/schemas/OpenAIModel'
        service_tier:
          $ref: '#/components/schemas/OpenAIServiceTier'
          default: default
      type: object
      required:
      - provider
      - model
      title: OpenAILLMSettings
    DeepgramSTTSettings:
      properties:
        provider:
          type: string
          const: deepgram
          title: Provider
        model:
          $ref: '#/components/schemas/DeepgramSTTModel'
          default: nova-3
        endpointing_ms:
          anyOf:
          - type: integer
          - type: 'null'
          title: Endpointing Ms
        eot_timeout_ms:
          anyOf:
          - type: integer
          - type: 'null'
          title: Eot Timeout Ms
        eot_threshold:
          anyOf:
          - type: number
          - type: 'null'
          title: Eot Threshold
        eager_eot_threshold:
          anyOf:
          - type: number
          - type: 'null'
          title: Eager Eot Threshold
      type: object
      required:
      - provider
      title: DeepgramSTTSettings
    CallSubject:
      properties:
        phone_number:
          type: string
          title: Phone Number
        sip_trunk_id:
          type: string
          title: Sip Trunk Id
        trunk_phone_number:
          anyOf:
          - type: string
          - type: 'null'
          title: Trunk Phone Number
        number_format:
          anyOf:
          - $ref: '#/components/schemas/NumberFormat'
          - type: 'null'
      type: object
      required:
      - phone_number
      - sip_trunk_id
      title: CallSubject
    ZohoCallActivityMessage:
      properties:
        type:
          type: string
          const: zoho_call_activity
          title: Type
          default: zoho_call_activity
        call_id:
          type: string
          title: Call Id
        record_id:
          type: string
          title: Record Id
        module:
          type: string
          pattern: ^[A-Za-z][A-Za-z0-9_]{0,79}$
          title: Module
          default: Leads
      type: object
      required:
      - call_id
      - record_id
      title: ZohoCallActivityMessage
    SarjF5TTSSettings:
      properties:
        provider:
          type: string
          const: sarj_f5
          title: Provider
        voice:
          $ref: '#/components/schemas/SarjF5TTSVoice'
          default: Male
      type: object
      required:
      - provider
      title: SarjF5TTSSettings
    SarjEouTurnDetection:
      properties:
        type:
          type: string
          const: sarj_eou
          title: Type
          default: sarj_eou
        threshold:
          type: number
          maximum: 1.0
          minimum: 0.0
          title: Threshold
          default: 0.5
        prediction_timeout:
          type: string
          format: duration
          title: Prediction Timeout
          default: PT0.5S
        min_endpointing_delay:
          type: string
          format: duration
          title: Min Endpointing Delay
          default: PT0.5S
        max_endpointing_delay:
          type: string
          format: duration
          title: Max Endpointing Delay
          default: PT3S
        targeted_stt_providers:
          items:
            $ref: '#/components/schemas/STTProvider'
          type: array
          title: Targeted Stt Providers
      type: object
      title: SarjEouTurnDetection
    GlobalOverriddenSettings:
      properties:
        type:
          type: string
          const: override
          title: Type
          default: override
        settings:
          additionalProperties:
            $ref: '#/components/schemas/GlobalSettings'
          propertyNames:
            $ref: '#/components/schemas/Language'
          type: object
          title: Settings
      type: object
      required:
      - settings
      title: GlobalOverriddenSettings
    AWSSTTSettings:
      properties:
        provider:
          type: string
          const: aws
          title: Provider
        region:
          type: string
          enum:
          - eu-central-1
          - us-east-1
          title: Region
          default: eu-central-1
      type: object
      required:
      - provider
      title: AWSSTTSettings
    NoOpMessage:
      properties:
        type:
          type: string
          const: no_op
          title: Type
          default: no_op
      type: object
      title: NoOpMessage
    OutboundDispatchTickMessage:
      properties:
        type:
          type: string
          const: outbound_dispatch_tick
          title: Type
          default: outbound_dispatch_tick
        tick_id:
          type: string
          title: Tick Id
      type: object
      title: OutboundDispatchTickMessage
    ScenarioSettingsOverride:
      properties:
        agent_profile_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Agent Profile Id
      type: object
      title: ScenarioSettingsOverride
    OpenAISTTSettings:
      properties:
        provider:
          type: string
          const: openai
          title: Provider
        model:
          type: string
          enum:
          - gpt-4o-transcribe
          - gpt-4o-mini-transcribe
          title: Model
        region:
          type: string
          const: default
          title: Region
          default: default
      type: object
      required:
      - provider
      - model
      title: OpenAISTTSettings
    AzureOpenAILLMSettings:
      properties:
        provider:
          type: string
          const: azure_openai
          title: Provider
        model:
          $ref: '#/components/schemas/AzureOpenAIModel'
      type: object
      required:
      - provider
      - model
      title: AzureOpenAILLMSettings
    BackChannelConfig:
      properties:
        type:
          type: string
          const: freq
          title: Type
          default: freq
        value:
          type: number
          maximum: 1.0
          exclusiveMinimum: 0.0
          title: Value
          default: 0.6
        whitelist:
          items:
            type: string
          type: array
          title: Whitelist
      type: object
      title: BackChannelConfig
    BackChannelMixConfig:
      properties:
        type:
          type: string
          const: mix
          title: Type
          default: mix
        value:
          type: number
          maximum: 1.0
          exclusiveMinimum: 0.0
          title: Value
          default: 0.6
        word_probability:
          type: number
          maximum: 1.0
          minimum: 0.0
          title: Word Probability
          default: 0.7
        whitelist:
          items:
            type: string
          type: array
          title: Whitelist
        sounds:
          items:
            $ref: '#/components/schemas/BackchannelAudioConfig'
          type: array
          minItems: 1
          title: Sounds
      type: object
      required:
      - sounds
      title: BackChannelMixConfig
    ZohoCRMRecordUpdateMessage:
      properties:
        type:
          type: string
          const: zoho_crm_record_update
          title: Type
          default: zoho_crm_record_update
        call_id:
          type: string
          title: Call Id
        record_id:
          type: string
          title: Record Id
        module:
          type: string
          pattern: ^[A-Za-z][A-Za-z0-9_]{0,79}$
          title: Module
          default: Leads
      type: object
      required:
      - call_id
      - record_id
      title: ZohoCRMRecordUpdateMessage
    GroqSTTModels:
      type: string
      enum:
      - whisper-large-v3
      - whisper-large-v3-turbo
      - distil-whisper-large-v3-en
      title: GroqSTTModels
    ReportColumn:
      properties:
        source:
          type: string
          enum:
          - standard
          - variable
          - collected_data
          title: Source
        key:
          type: string
          maxLength: 100
          minLength: 1
          title: Key
      additionalProperties: false
      type: object
      required:
      - source
      - key
      title: ReportColumn
    ElevenLabsTTSSettings:
      properties:
        model:
          $ref: '#/components/schemas/ElevenLabsModels'
        provider:
          type: string
          const: 11labs
          title: Provider
        arabic_voice_id:
          type: string
          title: Arabic Voice Id
        english_voice_id:
          type: string
          title: English Voice Id
          default: 21m00Tcm4TlvDq8ikWAM
        urdu_voice_id:
          type: string
          title: Urdu Voice Id
          default: 9cI5mhBtM4WtQ9Fo6jWQ
        region:
          $ref: '#/components/schemas/ElevenLabsRegion'
          default: eu
        speed:
          type: number
          maximum: 1.2
          minimum: 0.7
          title: Speed
          description: Speech speed (0.7-1.2)
          default: 1.0
      type: object
      required:
      - model
      - provider
      - arabic_voice_id
      title: ElevenLabsTTSSettings
    TaskType:
      type: string
      enum:
      - enhanced_transcription
      - call_outcome
      - scenario_insight_analysis
      - batch_report_generation
      - create_batch_calls
      - batch_calls_retry
      - start_batch_calls_tick
      - delete_old_tasks_tick
      - webhook_notification
      - zoho_crm_record_update
      - zoho_call_activity
      - stale_call_cleanup
      - call_queued_health_check
      - call_in_progress_health_check
      - call_retry
      - call_reports_enqueue
      - voice_migration
      - scenario_generation
      - process_messaging_message
      - create_default_agents
      - update_scenario_agent
      - slack_alert
      - conversation_export
      - dispatch_outbound_call
      - outbound_dispatch_tick
      - delete_expired_org_data_tick
      - no_op
      title: TaskType
    ElevenLabsModels:
      type: string
      enum:
      - eleven_multilingual_v2
      - eleven_flash_v2_5
      - eleven_turbo_v2_5
      title: ElevenLabsModels
    ListCallsInput:
      properties:
        call_outcome:
          anyOf:
          - type: string
          - type: 'null'
          title: Call Outcome
        cursor:
          anyOf:
          - type: string
            format: date-time
          - type: string
          - type: 'null'
          title: Cursor
        date_from:
          anyOf:
          - type: string
            format: date-time
          - type: 'null'
          title: Date From
        date_to:
          anyOf:
          - type: string
            format: date-time
          - type: 'null'
          title: Date To
        direction:
          anyOf:
          - $ref: '#/components/schemas/PhoneDirection'
          - type: 'null'
        duration_max:
          anyOf:
          - type: integer
          - type: 'null'
          title: Duration Max
        duration_min:
          anyOf:
          - type: integer
          - type: 'null'
          title: Duration Min
        exclude_scheduled:
          type: boolean
          title: Exclude Scheduled
          default: false
        limit:
          type: integer
          title: Limit
          default: 10
        organization_ids:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Organization Ids
        phone_number:
          anyOf:
          - type: string
          - type: 'null'
          title: Phone Number
        status:
          anyOf:
          - items:
              $ref: '#/components/schemas/CallStatus'
            type: array
          - type: 'null'
          title: Status
        report:
          anyOf:
          - items:
              $ref: '#/components/schemas/CallOutcomeStatus'
            type: array
          - type: 'null'
          title: Report
        scenario:
          anyOf:
          - type: string
          - type: 'null'
          title: Scenario
      type: object
      title: ListCallsInput
    CustomScenario:
      properties:
        type:
          type: string
          const: custom
          title: Type
        id:
          type: string
          title: Id
        variables:
          additionalProperties: true
          type: object
          title: Variables
          default: {}
        scenario_settings_override:
          anyOf:
          - $ref: '#/components/schemas/ScenarioSettingsOverride'
          - type: 'null'
      type: object
      required:
      - type
      - id
      title: CustomScenario
    CallOutcomeStatus:
      type: string
      enum:
      - success
      - failure
      - error
      title: CallOutcomeStatus
    CreateDefaultAgentsMessage:
      properties:
        type:
          type: string
          const: create_default_agents
          title: Type
          default: create_default_agents
      type: object
      title: CreateDefaultAgentsMessage
    Gender:
      type: string
      enum:
      - male
      - female
      title: Gender
    ElevenLabsSTTModel:
      type: string
      enum:
      - scribe_v1
      - scribe_v2
      - scribe_v2_realtime
      title: ElevenLabsSTTModel
    CerebrasLLMModel:
      type: string
      enum:
      - llama-3.1-8b-instruct
      title: CerebrasLLMModel
    ApiCall:
      properties:
        type:
          type: string
          const: api
          title: Type
          default: api
        call_id:
          type: string
          title: Call Id
        identity:
          type: string
          title: Identity
      type: object
      required:
      - call_id
      - identity
      title: ApiCall
    STTProvider:
      type: string
      enum:
      - google
      - azure
      - aws
      - openai
      - elevenlabs
      - groq
      - speechmatics
      - hamsa
      - sarj_groq
      - sarj_custom
      - deepgram
      title: STTProvider
    WebhookNotificationMessage:
      properties:
        type:
          type: string
          const: webhook_notification
          title: Type
          default: webhook_notification
        call_id:
          type: string
          title: Call Id
      type: object
      required:
      - call_id
      title: WebhookNotificationMessage
    GlobalModelConfig:
      properties:
        stt:
          anyOf:
          - $ref: '#/components/schemas/GoogleSTTSettings'
          - $ref: '#/components/schemas/AzureSTTSettings'
          - $ref: '#/components/schemas/AWSSTTSettings'
          - $ref: '#/components/schemas/GroqSTTSettings'
          - $ref: '#/components/schemas/OpenAISTTSettings'
          - $ref: '#/components/schemas/ElevenLabsSTTSettings'
          - $ref: '#/components/schemas/SpeechmaticsSTTSettings'
          - $ref: '#/components/schemas/HamsaSTTSettings'
          - $ref: '#/components/schemas/SarjGroqSTTSettings'
          - $ref: '#/components/schemas/SarjCustomSTTSettings'
          - $ref: '#/components/schemas/DeepgramSTTSettings'
          title: Stt
        stt_fallback:
          anyOf:
          - $ref: '#/components/schemas/DisableSTTFallback'
          - $ref: '#/components/schemas/STTFallbackConfig'
          title: Stt Fallback
        tts:
          anyOf:
          - $ref: '#/components/schemas/ElevenLabsTTSSettings'
          - $ref: '#/components/schemas/AzureTTSSettings'
          - $ref: '#/components/schemas/OpenAITTSSettings'
          - $ref: '#/components/schemas/AWSTTSSettings'
          - $ref: '#/components/schemas/GroqTTSSettings'
          - $ref: '#/components/schemas/HamsaTTSSettings'
          - $ref: '#/components/schemas/CartesiaTTSSettings'
          - $ref: '#/components/schemas/DeepgramTTSSettings'
          - $ref: '#/components/schemas/SarjF5TTSSettings'
          - $ref: '#/components/schemas/SarjOmniTTSSettings'
          title: Tts
        llm:
          anyOf:
          - $ref: '#/components/schemas/OpenAILLMSettings'
          - $ref: '#/components/schemas/GeminiLLMSettings'
          - $ref: '#/components/schemas/GroqLLMSettings'
          - $ref: '#/components/schemas/AzureOpenAILLMSettings'
          - $ref: '#/components/schemas/CerebrasLLMSettings'
          title: Llm
        voice_details:
          $ref: '#/components/schemas/TTSVoice'
        voice_id:
          type: string
          title: Voice Id
      type: object
      required:
      - stt
      - tts
      - llm
      - voice_details
      - voice_id
      title: GlobalModelConfig
    EnhancedTranscriptionMessage:
      properties:
        type:
          type: string
          const: enhanced_transcription
          title: Type
          default: enhanced_transcription
        call_id:
          type: string
          title: Call Id
      type: object
      required:
      - call_id
      title: EnhancedTranscriptionMessage
    STTFallbackConfig:
      properties:
        type:
          type: string
          const: enable
          title: Type
          default: enable
        models:
          items:
            anyOf:
            - $ref: '#/components/schemas/GoogleSTTSettings'
            - $ref: '#/components/schemas/AzureSTTSettings'
            - $ref: '#/components/schemas/AWSSTTSettings'
            - $ref: '#/components/schemas/GroqSTTSettings'
            - $ref: '#/components/schemas/OpenAISTTSettings'
            - $ref: '#/components/schemas/ElevenLabsSTTSettings'
            - $ref: '#/components/schemas/SpeechmaticsSTTSettings'
            - $ref: '#/components/schemas/DeepgramSTTSettings'
          type: array
          maxItems: 2
          title: Models
      type: object
      title: STTFallbackConfig
    SarjOmniTTSSettings:
      properties:
        provider:
          type: string
          const: sarj_omni
          title: Provider
        voice:
          type: string
          pattern: ^(?:clone:)?[A-Za-z0-9][A-Za-z0-9_-]{0,63}$
          title: Voice
          description: Built-in voice ID or clone:<profile_id>
          default: ars_male
        speed:
          type: number
          maximum: 1.2
          minimum: 0.8
          title: Speed
          description: Speech speed (0.8-1.2)
          default: 1.0
      type: object
      required:
      - provider
      title: SarjOmniTTSSettings
    ElevenLabsSTTSettings:
      properties:
        provider:
          type: string
          const: elevenlabs
          title: Provider
        model:
          $ref: '#/components/schemas/ElevenLabsSTTModel'
          default: scribe_v1
        region:
          $ref: '#/components/schemas/ElevenLabsRegion'
          default: eu
      type: object
      required:
      - provider
      title: ElevenLabsSTTSettings
    CallOutcomeMessage:
      properties:
        type:
          type: string
          const: call_outcome
          title: Type
          default: call_outcome
        call_id:
          type: string
          title: Call Id
        is_retry:
          type: boolean
          title: Is Retry
          default: false
      type: object
      required:
      - call_id
      title: CallOutcomeMessage
    Language:
      type: string
      enum:
      - en
      - ar
      - ur
      title: Language
      description: Language codes in ISO 639-1
    DeepgramTTSSettings:
      properties:
        provider:
          type: string
          const: deepgram
          title: Provider
        model:
          $ref: '#/components/schemas/DeepgramTTSModel'
          default: aura-2
        voice:
          type: string
          title: Voice
      type: object
      required:
      - provider
      - voice
      title: DeepgramTTSSettings
    CallInProgressHealthCheckMessage:
      properties:
        type:
          type: string
          const: call_in_progress_health_check
          title: Type
          default: call_in_progress_health_check
        call_id:
          type: string
          title: Call Id
      type: object
      required:
      - call_id
      title: CallInProgressHealthCheckMessage
    TaskStatus:
      type: string
      enum:
      - pending
      - running
      - completed
      - failed
      - cancelled
      title: TaskStatus
    CerebrasLLMSettings:
      properties:
        provider:
          type: string
          const: cerebras
          title: Provider
          default: cerebras
        model:
          $ref: '#/components/schemas/CerebrasLLMModel'
      type: object
      required:
      - model
      title: CerebrasLLMSettings
    SlackAlertMessage:
      properties:
        type:
          type: string
          const: slack_alert
          title: Type
          default: slack_alert
        payload:
          $ref: '#/components/schemas/GenericSlackAlert'
      type: object
      required:
      - payload
      title: SlackAlertMessage
    ConversationExportMessage:
      properties:
        type:
          type: string
          const: conversation_export
          title: Type
          default: conversation_export
        filters

# --- truncated at 32 KB (54 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/sarj-ai-developer-api/refs/heads/main/openapi/sarj-ai-developer-api-reports-api-openapi.yml