---
title: "Voice Agent"
method: PATCH
path: "/api/external/chatbot/{chatbotId}/voice-agent"
---

# Voice Agent

`PATCH /api/external/chatbot/{chatbotId}/voice-agent`

Voice Agent

## Headers

- `x-api-key` string

## Request body

- object
  - `agentId` string
  - `appearance` object
    - `backgroundColor` string
    - `borderColor` string
    - `buttonColor` string
    - `buttonRadius` number
    - `buttonTextColor` string
    - `cardRadius` number
    - `focusOutlineColor` string
    - `textColor` string
  - `avatar` object
    - `imageUrl` string
  - `model` object
    - `max_output_tokens` number
    - `temperature` number
  - `text` object
    - `callToAction` string
    - `endCall` string
    - `listeningStatus` string
    - `speakingStatus` string
    - `startCall` string
  - `vad` object
    - `prefix_padding_ms` number
    - `silence_duration_ms` number
    - `threshold` number
  - `voice` string

## Response `200`

Example

- object
  - `message` string
  - `voice_widget_config` object
    - `agentId` string
    - `appearance` object
      - `backgroundColor` string
      - `borderColor` string
      - `buttonColor` string
      - `buttonRadius` number
      - `buttonTextColor` string
      - `cardRadius` number
      - `focusOutlineColor` string
      - `textColor` string
    - `avatar` object
      - `imageUrl` string
    - `model` object
      - `max_output_tokens` number
      - `temperature` number
    - `text` object
      - `callToAction` string
      - `endCall` string
      - `listeningStatus` string
      - `speakingStatus` string
      - `startCall` string
    - `vad` object
      - `prefix_padding_ms` number
      - `silence_duration_ms` number
      - `threshold` number
    - `voice` string

## Changes

- **2025-01-24** `a70376d72301` — 1 info
  - added the media type `application/json` for the response with the status `200`
- **2025-01-24** `6942be06fd1e` — 1 info
  - endpoint added
- **2025-01-22** `9a74b2d0931e` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/dasomx/apis/okchat2-0/changes/api/external/chatbot/:chatbotId/voice-agent/patch.md)

---

[API](https://skmtc.dev/dasomx/apis/okchat2-0.md) · [All operations](https://skmtc.dev/dasomx/apis/okchat2-0/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/dasomx/okchat2-0/revisions/53c69266d405/schema)