# Get Embed Config

> GET /api/v1/public/embed/config/{token} — request parameters and responses from the Menace Voice API schema.

`GET /api/v1/public/embed/config/{token}`

{/* 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.

### Parameters

| Name | Location | Type | Required | Description and constraints |
| --- | --- | --- | --- | --- |
| token | path | string | yes |  |

### Response 200

Successful Response

application/json: EmbedConfigResponse (object).

| Field | Type | Required | Description and constraints |
| --- | --- | --- | --- |
| workflow_id | integer | yes |  |
| settings | object | yes |  |
| texts | WidgetTexts (object) | yes |  |
| theme | string | yes |  |
| position | string | yes |  |
| button_text | string | yes |  |
| button_color | string | yes |  |
| size | string | yes |  |
| auto_start | boolean | yes |  |
| turn_enabled | boolean | yes |  |
| force_turn_relay | boolean | yes |  |

### Response 404

Not found

### Response 422

Validation Error

application/json: HTTPValidationError (object).

| Field | Type | Required | Description and constraints |
| --- | --- | --- | --- |
| detail | array of ValidationError (object) | no |  |

## OpenAPI

````yaml api-reference/openapi.json get /api/v1/public/embed/config/{token}
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/public/embed/config/{token}:
    get:
      tags:
        - main
      summary: Get Embed Config
      description: |-
        Get embed configuration without creating a session.

        This endpoint is used to fetch widget configuration for display purposes
        without actually starting a call session.
      operationId: get_embed_config_api_v1_public_embed_config__token__get
      parameters:
        - name: token
          in: path
          required: true
          schema:
            type: string
            title: Token
      responses:
        "200":
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/EmbedConfigResponse"
        "404":
          description: Not found
        "422":
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/HTTPValidationError"
components:
  schemas:
    EmbedConfigResponse:
      properties:
        workflow_id:
          type: integer
          title: Workflow Id
        settings:
          additionalProperties: true
          type: object
          title: Settings
        texts:
          $ref: "#/components/schemas/WidgetTexts"
        theme:
          type: string
          title: Theme
        position:
          type: string
          title: Position
        button_text:
          type: string
          title: Button Text
        button_color:
          type: string
          title: Button Color
        size:
          type: string
          title: Size
        auto_start:
          type: boolean
          title: Auto Start
        turn_enabled:
          type: boolean
          title: Turn Enabled
        force_turn_relay:
          type: boolean
          title: Force Turn Relay
      type: object
      required:
        - workflow_id
        - settings
        - texts
        - theme
        - position
        - button_text
        - button_color
        - size
        - auto_start
        - turn_enabled
        - force_turn_relay
      title: EmbedConfigResponse
      description: Response model for embed configuration
    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
    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.
````