---
title: "Update a team's voice call behavior settings"
method: PATCH
path: "/v1/teams/{team_id}/call-settings"
tags: ["teams"]
---

# Update a team's voice call behavior settings

`PATCH /v1/teams/{team_id}/call-settings`

Partially update voice call behavior settings on this team.

Unset fields are left unchanged; the merged result is fully validated.
The write is strictly team-scoped (row-locked, actor-audited) — the
runtime overlays this JSON onto the in-memory pipeline configuration at
call setup, so the (possibly saved/shared) VPC row is never mutated by a
team settings edit.

## Path parameters

- `team_id` string, uuid, required

## Request body

- VoiceCallSettingsUpdate — All-optional PATCH input for voice call settings. Unset fields (``None``) mean "don't change". Only explicitly provided fields are applied by ``merge_patch``.
  - `interruptions_enabled` boolean, nullable
  - `interruption_min_words` integer, nullable
  - `interruption_min_duration_ms` integer, nullable
  - `interruption_backoff_ms` integer, nullable
  - `interruption_trigger_phrases` string[], nullable
  - `interruption_hard_phrases` string[], nullable
  - `interruption_final_transcript_grace_ms` integer, nullable
  - `dtmf_enabled` boolean, nullable
  - `dtmf_termination_digit` string, nullable
  - `dtmf_inter_digit_timeout_ms` integer, nullable
  - `dtmf_max_digits` integer, nullable
  - `dtmf_prefix` string, nullable
  - `max_call_duration_ms` integer, nullable
  - `silence_timeout_ms` integer, nullable
  - `silence_reminder_count` integer, nullable
  - `silence_reminder_mode` 'static' | 'auto', nullable
  - `silence_reminder_message` string, nullable
  - `silence_end_action` 'hangup_immediate' | 'speak_then_hangup', nullable
  - `silence_end_message` string, nullable
  - `voicemail_detection_mode` 'off' | 'leave_message', nullable
  - `voicemail_detection_timeout_ms` integer, nullable
  - `voicemail_detection_model` string, nullable
  - `voicemail_message` string, nullable
  - `background_audio_enabled` boolean, nullable
  - `background_audio_preset` 'office' | 'cafe' | 'city' | 'keyboard_typing' | 'keyboard_typing2', nullable
  - `background_audio_volume` number, nullable
  - `background_audio_loop` boolean, nullable
  - `recording_enabled` boolean, nullable

## Response `200`

Successful Response

- VoiceCallSettings — Complete voice call behavior settings with all defaults populated. Stored as a JSON column on ``AgentRevision``, ``Team``, and ``Persona``. Every field has a default so ``NULL``/``{}`` stored JSON resolves to the schema defaults — the legacy ``VoicePipelineConfig`` scalar columns these defaults once mirrored were dropped by migration 0219.
  - `interruptions_enabled` boolean
  - `interruption_min_words` integer
  - `interruption_min_duration_ms` integer
  - `interruption_backoff_ms` integer
  - `interruption_trigger_phrases` string[]
  - `interruption_hard_phrases` string[]
  - `interruption_final_transcript_grace_ms` integer
  - `dtmf_enabled` boolean
  - `dtmf_termination_digit` string
  - `dtmf_inter_digit_timeout_ms` integer
  - `dtmf_max_digits` integer
  - `dtmf_prefix` string
  - `max_call_duration_ms` integer
  - `silence_timeout_ms` integer
  - `silence_reminder_count` integer
  - `silence_reminder_mode` 'static' | 'auto'
  - `silence_reminder_message` string, nullable
  - `silence_end_action` 'hangup_immediate' | 'speak_then_hangup'
  - `silence_end_message` string, nullable
  - `voicemail_detection_mode` 'off' | 'leave_message'
  - `voicemail_detection_timeout_ms` integer
  - `voicemail_detection_model` string, nullable
  - `voicemail_message` string, nullable
  - `background_audio_enabled` boolean
  - `background_audio_preset` 'office' | 'cafe' | 'city' | 'keyboard_typing' | 'keyboard_typing2', nullable
  - `background_audio_volume` number
  - `background_audio_loop` boolean
  - `recording_enabled` boolean

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/oneloop-hq/apis/feather-api.md) · [All operations](https://skmtc.net/oneloop-hq/apis/feather-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/oneloop-hq/feather-api/revisions/9cd7291d4228/schema)