---
title: "PATCH /clinic-config/voice-ai - Update Voice AI settings"
method: PATCH
path: "/clinic-config/voice-ai"
tags: ["ClinicConfig"]
---

# PATCH /clinic-config/voice-ai - Update Voice AI settings

`PATCH /clinic-config/voice-ai`

## Request

- Base URL: `https://api.clinicos.vet/backend/business`
- URL: `https://api.clinicos.vet/backend/business/clinic-config/voice-ai`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/clinicos/apis/pawthosx-business-api-v1/docs/clinic-config/voice-ai/patch.ts> (a function with typed inputs; its response is checked against the schema)

## Request body

- VoiceAiSettingsDto: Voice AI agent settings for autonomous call handling via Retell AI.
  - `enabled` boolean
  - `retellAgentId` string, nullable
  - `transferNumber` string, nullable
  - `adoptionMode` string, nullable
  - `activeHoursStart` string, nullable
  - `activeHoursEnd` string, nullable
  - `overflowRingSeconds` union
    - integer
    - string, int32
  - `transferTolerance` string, nullable
  - `maxTurnsBeforeTransfer` union
    - integer
    - string, int32
  - `maxCallDurationMinutes` union
    - integer
    - string, int32
  - `emergencyKeywords` string[]
  - `allowedActions` string[]
  - `customGreeting` string, nullable
  - `voiceModel` AiModelConfigDto: Configuration for an AI model (provider + model ID)
    - `provider` string: AI provider: "openai" or "anthropic"
    - `modelId` string: Model identifier (e.g., "claude-sonnet-4-6", "gpt-5.4-mini"). Empty = use the infra-configured default. Model ids live in the ModelCatalog config, not hardcoded.
    - `tier` string, nullable: The clinic's tier for a tiered feature ("standard" / "premium"); null = the feature's default tier. On save it is the only field read — provider and model id are ignored and come back as the tier's model (docs/ai-model-tiers.md).
  - `clinicName` string, nullable
  - `clinicAddress` string, nullable
  - `clinicPhone` string, nullable
  - `customFaqs` string, nullable

## Response `200`

OK

- VoiceAiSettingsDto: Voice AI agent settings for autonomous call handling via Retell AI.
  - `enabled` boolean
  - `retellAgentId` string, nullable
  - `transferNumber` string, nullable
  - `adoptionMode` string, nullable
  - `activeHoursStart` string, nullable
  - `activeHoursEnd` string, nullable
  - `overflowRingSeconds` union
    - integer
    - string, int32
  - `transferTolerance` string, nullable
  - `maxTurnsBeforeTransfer` union
    - integer
    - string, int32
  - `maxCallDurationMinutes` union
    - integer
    - string, int32
  - `emergencyKeywords` string[]
  - `allowedActions` string[]
  - `customGreeting` string, nullable
  - `voiceModel` AiModelConfigDto: Configuration for an AI model (provider + model ID)
    - `provider` string: AI provider: "openai" or "anthropic"
    - `modelId` string: Model identifier (e.g., "claude-sonnet-4-6", "gpt-5.4-mini"). Empty = use the infra-configured default. Model ids live in the ModelCatalog config, not hardcoded.
    - `tier` string, nullable: The clinic's tier for a tiered feature ("standard" / "premium"); null = the feature's default tier. On save it is the only field read — provider and model id are ignored and come back as the tier's model (docs/ai-model-tiers.md).
  - `clinicName` string, nullable
  - `clinicAddress` string, nullable
  - `clinicPhone` string, nullable
  - `customFaqs` string, nullable

## Changes

- **2026-10-28** `099cf36186e0`: 6 info
  - added the new optional request property `voiceModel/oneOf[#/components/schemas/AiModelConfigDto]/tier` (media type: application/json)
  - added the new optional request property `voiceModel/oneOf[#/components/schemas/AiModelConfigDto]/tier` (media type: text/json)
  - added the new optional request property `voiceModel/oneOf[#/components/schemas/AiModelConfigDto]/tier` (media type: application/*+json)
  - added the optional property `voiceModel/oneOf[#/components/schemas/AiModelConfigDto]/tier` to the response with the `200` status (media type: text/plain)
  - …2 more

[Operation history](https://skmtc.dev/clinicos/apis/pawthosx-business-api-v1/changes/clinic-config/voice-ai/patch.md)

---

[API](https://skmtc.dev/clinicos/apis/pawthosx-business-api-v1.md) - [All operations](https://skmtc.dev/clinicos/apis/pawthosx-business-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/clinicos/apis/pawthosx-business-api-v1/revisions/099cf36186e0?raw)