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

# Get a team's voice call behavior settings

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

Return the team's canonical ``VoiceCallSettings``.

Team-scoped reads never consult the legacy VPC scalar columns: a
``NULL``/empty JSON column means schema defaults. This is the LIVE value
even while a saved config is linked — saved configs are pipeline-only and
never carry call behavior.

## Path parameters

- `team_id` string, uuid, required

## 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)