# Get Default Configurations

> GET /api/v1/user/configurations/defaults — request parameters and responses from the Menace Voice API schema.

`GET /api/v1/user/configurations/defaults`

{/* Generated by scripts/sync_docs_api.mjs. Edit the API schema source to change the contract. */}

See [authentication](/api-reference/authentication) for workspace API access. Public embed and artifact endpoints use their documented session or access tokens.

## API contract for documentation tools

Generated from the OpenAPI schema. Do not infer a different parameter type from an example. Authentication headers are alternatives as explained in the authentication guide.

### Response 200

Successful Response

application/json: DefaultConfigurationsResponse (object).

| Field | Type | Required | Description and constraints |
| --- | --- | --- | --- |
| llm | object | yes |  |
| tts | object | yes |  |
| stt | object | yes |  |
| embeddings | object | yes |  |
| realtime | object | yes |  |
| default_providers | object | yes |  |
| workflow_configurations | WorkflowConfigurationDefaults (object) | yes |  |
| default_call_dispositions | array of CallDispositionOption (object) | yes | Built-in suggestions for call-disposition extraction. They do not enable extraction until saved in workflow_configurations.call_dispositions. |
| text_chat_inactivity_timeout_constraints | TextChatInactivityTimeoutConstraints (object) | yes |  |
| widget_text_defaults | WidgetTexts (object) | yes |  |

### Response 404

Not found

## OpenAPI

````yaml api-reference/openapi.json get /api/v1/user/configurations/defaults
openapi: 3.1.0
info:
  title: Menace Voice API
  description: API for Menace Voice agents
  version: 1.0.0
servers:
  - url: https://voice.menaceui.com
    description: Production
  - url: http://localhost:8000
    description: Local development
paths:
  /api/v1/user/configurations/defaults:
    get:
      tags:
        - main
      summary: Get Default Configurations
      operationId: get_default_configurations_api_v1_user_configurations_defaults_get
      responses:
        "200":
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/DefaultConfigurationsResponse"
        "404":
          description: Not found
components:
  schemas:
    AmbientNoiseConfigurationDefaults:
      properties:
        enabled:
          type: boolean
          title: Enabled
          default: false
        volume:
          type: number
          title: Volume
          default: 0.3
      additionalProperties: true
      type: object
      title: AmbientNoiseConfigurationDefaults
    CallDispositionOption:
      properties:
        code:
          type: string
          maxLength: 64
          minLength: 1
          pattern: ^[A-Za-z][A-Za-z0-9_-]*$
          title: Code
          description: Stable code recorded when this outcome is selected.
        description:
          type: string
          maxLength: 1000
          minLength: 1
          title: Description
          description: Business criteria for selecting this disposition.
      type: object
      required:
        - code
        - description
      title: CallDispositionOption
      description: One business outcome the terminal classifier may select.
    DefaultConfigurationsResponse:
      properties:
        llm:
          additionalProperties:
            additionalProperties: true
            type: object
          type: object
          title: Llm
        tts:
          additionalProperties:
            additionalProperties: true
            type: object
          type: object
          title: Tts
        stt:
          additionalProperties:
            additionalProperties: true
            type: object
          type: object
          title: Stt
        embeddings:
          additionalProperties:
            additionalProperties: true
            type: object
          type: object
          title: Embeddings
        realtime:
          additionalProperties:
            additionalProperties: true
            type: object
          type: object
          title: Realtime
        default_providers:
          additionalProperties:
            type: string
          type: object
          title: Default Providers
        workflow_configurations:
          $ref: "#/components/schemas/WorkflowConfigurationDefaults"
        default_call_dispositions:
          items:
            $ref: "#/components/schemas/CallDispositionOption"
          type: array
          title: Default Call Dispositions
          description: Built-in suggestions for call-disposition extraction. They do not
            enable extraction until saved in
            workflow_configurations.call_dispositions.
        text_chat_inactivity_timeout_constraints:
          $ref: "#/components/schemas/TextChatInactivityTimeoutConstraints"
        widget_text_defaults:
          $ref: "#/components/schemas/WidgetTexts"
      type: object
      required:
        - llm
        - tts
        - stt
        - embeddings
        - realtime
        - default_providers
        - workflow_configurations
        - default_call_dispositions
        - text_chat_inactivity_timeout_constraints
        - widget_text_defaults
      title: DefaultConfigurationsResponse
    ExternalPBXFieldMapping:
      properties:
        context_path:
          type: string
          maxLength: 255
          minLength: 1
          title: Context Path
        destination_field:
          type: string
          pattern: ^[A-Za-z][A-Za-z0-9_]{0,63}$
          title: Destination Field
      type: object
      required:
        - context_path
        - destination_field
      title: ExternalPBXFieldMapping
      description: Map one gathered-context value to a provider-native field.
    OnboardingSetup:
      properties:
        agent_brief:
          type: string
          maxLength: 8000
          minLength: 1
          title: Agent Brief
        tone:
          type: string
          maxLength: 100
          minLength: 1
          title: Tone
        language:
          type: string
          maxLength: 100
          minLength: 1
          title: Language
        voice_provider:
          type: string
          maxLength: 100
          minLength: 1
          title: Voice Provider
        voice_name:
          type: string
          maxLength: 255
          minLength: 1
          title: Voice Name
        behavior_notes:
          anyOf:
            - type: string
              maxLength: 4000
            - type: "null"
          title: Behavior Notes
        workflow_stages:
          items:
            type: string
          type: array
          maxItems: 8
          title: Workflow Stages
          description: Optional template hints; the planner chooses the stages from the
            brief.
        agent_name:
          type: string
          maxLength: 255
          minLength: 1
          title: Agent Name
        use_case:
          type: string
          maxLength: 2000
          minLength: 1
          title: Use Case
        call_type:
          type: string
          enum:
            - inbound
            - outbound
          title: Call Type
      type: object
      required:
        - agent_brief
        - tone
        - language
        - voice_provider
        - voice_name
        - agent_name
        - use_case
        - call_type
      title: OnboardingSetup
    TextChatInactivityTimeoutConstraints:
      properties:
        default_seconds:
          type: integer
          title: Default Seconds
          default: 1800
        minimum_seconds:
          type: integer
          title: Minimum Seconds
          default: 60
        maximum_seconds:
          type: integer
          title: Maximum Seconds
          default: 10500
      type: object
      title: TextChatInactivityTimeoutConstraints
      description: Backend-owned timeout metadata consumed by generated API clients.
    WidgetTexts:
      properties:
        endChatText:
          type: string
          title: Endchattext
          default: End chat
        conversationEndedText:
          type: string
          title: Conversationendedtext
          default: Conversation ended.
        startNewChatText:
          type: string
          title: Startnewchattext
          default: Start new chat
        chatRetryText:
          type: string
          title: Chatretrytext
          default: Retry
        chatInputPlaceholder:
          type: string
          title: Chatinputplaceholder
          default: Type a message…
        sendMessageLabel:
          type: string
          title: Sendmessagelabel
          default: Send message
        closeChatLabel:
          type: string
          title: Closechatlabel
          default: Close chat
        voiceConnectingText:
          type: string
          title: Voiceconnectingtext
          default: Connecting…
        voiceEndCallText:
          type: string
          title: Voiceendcalltext
          default: End Call
        voiceRetryText:
          type: string
          title: Voiceretrytext
          default: Retry
        voiceReadyTitle:
          type: string
          title: Voicereadytitle
          default: Ready to Connect
        voiceConnectingSubtext:
          type: string
          title: Voiceconnectingsubtext
          default: Please wait while we establish the connection
        voiceConnectedTitle:
          type: string
          title: Voiceconnectedtitle
          default: Connected
        voiceConnectedSubtext:
          type: string
          title: Voiceconnectedsubtext
          default: Your voice call is now active
        voiceCallEndedTitle:
          type: string
          title: Voicecallendedtitle
          default: Call ended
        voiceCallEndedSubtext:
          type: string
          title: Voicecallendedsubtext
          default: Click below to start a new call
        voiceConnectionFailedTitle:
          type: string
          title: Voiceconnectionfailedtitle
          default: Connection failed
        voiceConnectionFailedSubtext:
          type: string
          title: Voiceconnectionfailedsubtext
          default: Please check your microphone and try again
        voiceConnectionLostTitle:
          type: string
          title: Voiceconnectionlosttitle
          default: Connection lost
        voiceConnectionLostSubtext:
          type: string
          title: Voiceconnectionlostsubtext
          default: The call has been disconnected
      type: object
      title: WidgetTexts
      description: Every visitor-facing string the embed widget can render.
    WorkflowConfigurationDefaults:
      properties:
        agent_setup:
          anyOf:
            - $ref: "#/components/schemas/OnboardingSetup"
            - type: "null"
        voice_clone_id:
          anyOf:
            - type: string
              maxLength: 36
              minLength: 1
            - type: "null"
          title: Voice Clone Id
        ambient_noise_configuration:
          $ref: "#/components/schemas/AmbientNoiseConfigurationDefaults"
        max_call_duration:
          type: integer
          maximum: 1200
          exclusiveMinimum: 0
          title: Max Call Duration
          default: 300
        max_user_idle_timeout:
          type: number
          title: Max User Idle Timeout
          default: 10
        smart_turn_stop_secs:
          type: number
          title: Smart Turn Stop Secs
          default: 2
        turn_start_strategy:
          type: string
          enum:
            - default
            - min_words
            - provisional_vad
          title: Turn Start Strategy
          default: default
        turn_start_min_words:
          type: integer
          title: Turn Start Min Words
          default: 3
        provisional_vad_pause_secs:
          type: number
          title: Provisional Vad Pause Secs
          default: 1.5
        turn_stop_strategy:
          type: string
          enum:
            - transcription
            - turn_analyzer
          title: Turn Stop Strategy
          default: transcription
        dictionary:
          type: string
          title: Dictionary
          default: ""
        context_compaction_enabled:
          type: boolean
          title: Context Compaction Enabled
          default: false
        call_dispositions:
          items:
            $ref: "#/components/schemas/CallDispositionOption"
          type: array
          maxItems: 50
          title: Call Dispositions
          description: Allowed business outcomes for terminal call classification. Each
            entry defines the exact stored code and the criteria for selecting
            it.
        text_chat_inactivity_timeout_seconds:
          type: integer
          maximum: 10500
          minimum: 60
          title: Text Chat Inactivity Timeout Seconds
          default: 1800
        external_pbx_field_mappings:
          items:
            $ref: "#/components/schemas/ExternalPBXFieldMapping"
          type: array
          maxItems: 100
          title: External Pbx Field Mappings
        external_pbx_lead_headers:
          items:
            type: string
            pattern: ^[A-Za-z][A-Za-z0-9_]{0,63}$
          type: array
          maxItems: 50
          title: External Pbx Lead Headers
      additionalProperties: true
      type: object
      title: WorkflowConfigurationDefaults
````