> ## Documentation Index > Fetch the complete documentation index at: https://doc.featherhq.com/llms.txt > Use this file to discover all available pages before exploring further. # Detach a team from a saved config into an inline copy ## OpenAPI ````yaml /api-reference/openapi.json post /v1/voice/teams/{team_id}/voice-config/detach openapi: 3.1.0 info: title: Feather API description: >- Unified customer experience platform API. Manages identity, conversations, memory, agents, procedures, policies, model routing, knowledge bases, integrations, and runtime execution. version: 1.87.0 servers: - url: https://api-sandbox.featherhq.com description: Sandbox - url: http://localhost:8000 description: Local dev security: [] paths: /v1/voice/teams/{team_id}/voice-config/detach: post: tags: - voice summary: Detach a team from a saved config into an inline copy operationId: detachTeamVoiceConfig parameters: - name: team_id in: path required: true schema: type: string format: uuid title: Team Id responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/TeamVoiceConfigResponse' '400': description: Bad request content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '401': description: Authentication required content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '404': description: Resource not found content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - APIKeyHeader: [] components: schemas: TeamVoiceConfigResponse: properties: id: type: string format: uuid title: Id organization_id: anyOf: - type: string format: uuid - type: 'null' title: Organization Id name: anyOf: - type: string - type: 'null' title: Name agent_id: anyOf: - type: string format: uuid - type: 'null' title: Agent Id team_id: anyOf: - type: string format: uuid - type: 'null' title: Team Id persona_id: anyOf: - type: string format: uuid - type: 'null' title: Persona Id voice_id: type: string format: uuid title: Voice Id voice: $ref: '#/components/schemas/VoiceOut' voice_tuning: additionalProperties: true type: object title: Voice Tuning stt_provider: type: string title: Stt Provider stt_model: anyOf: - type: string - type: 'null' title: Stt Model stt_language: type: string title: Stt Language stt_provider_data: additionalProperties: true type: object title: Stt Provider Data tts_speed: anyOf: - type: number - type: 'null' title: Tts Speed tts_provider_data: additionalProperties: true type: object title: Tts Provider Data vad_provider: type: string title: Vad Provider vad_provider_data: additionalProperties: true type: object title: Vad Provider Data local_vad_params: additionalProperties: true type: object title: Local Vad Params turn_analyzer_params: additionalProperties: true type: object title: Turn Analyzer Params interruption_sensitivity: type: number title: Interruption Sensitivity hard_turn_timeout_ms: anyOf: - type: integer - type: 'null' title: Hard Turn Timeout Ms min_endpoint_delay_ms: type: integer title: Min Endpoint Delay Ms max_endpoint_delay_ms: type: integer title: Max Endpoint Delay Ms preemptive_generation_enabled: type: boolean title: Preemptive Generation Enabled end_call_phrases: items: type: string type: array title: End Call Phrases pronunciation_overrides: additionalProperties: type: string type: object title: Pronunciation Overrides noise_cancellation_enabled: type: boolean title: Noise Cancellation Enabled noise_cancellation_provider: $ref: '#/components/schemas/NoiseCancellationProvider' normalize_for_speech: type: boolean title: Normalize For Speech audio_in_sample_rate: type: integer title: Audio In Sample Rate audio_out_sample_rate: type: integer title: Audio Out Sample Rate metrics_enabled: type: boolean title: Metrics Enabled usage_metrics_enabled: type: boolean title: Usage Metrics Enabled heartbeats_period_secs: anyOf: - type: integer - type: 'null' title: Heartbeats Period Secs idle_pipeline_timeout_ms: anyOf: - type: integer - type: 'null' title: Idle Pipeline Timeout Ms language: type: string title: Language locale: anyOf: - type: string - type: 'null' title: Locale multilingual_enabled: type: boolean title: Multilingual Enabled multilingual_languages: items: type: string type: array title: Multilingual Languages linked_agent_count: type: integer title: Linked Agent Count default: 0 linked_agent_names: items: type: string type: array title: Linked Agent Names linked_team_count: type: integer title: Linked Team Count default: 0 linked_team_names: items: type: string type: array title: Linked Team Names metadata_: additionalProperties: true type: object title: Metadata first_speaking_config: anyOf: - $ref: '#/components/schemas/FirstSpeakingConfig' - type: 'null' warnings: items: type: string type: array title: Warnings effective_stt_model: anyOf: - type: string - type: 'null' title: Effective Stt Model effective_stt_provider_data: anyOf: - additionalProperties: true type: object - type: 'null' title: Effective Stt Provider Data effective_tts_model: anyOf: - type: string - type: 'null' title: Effective Tts Model created_at: type: string format: date-time title: Created At updated_at: type: string format: date-time title: Updated At source: type: string enum: - inline - saved title: Source saved_config_id: anyOf: - type: string format: uuid - type: 'null' title: Saved Config Id has_inline_fallback: type: boolean title: Has Inline Fallback additionalProperties: false type: object required: - id - voice_id - voice - stt_provider - stt_language - vad_provider - interruption_sensitivity - min_endpoint_delay_ms - max_endpoint_delay_ms - preemptive_generation_enabled - noise_cancellation_enabled - noise_cancellation_provider - normalize_for_speech - audio_in_sample_rate - audio_out_sample_rate - metrics_enabled - usage_metrics_enabled - language - multilingual_enabled - created_at - updated_at - source - has_inline_fallback title: TeamVoiceConfigResponse description: >- Config response for a team, augmented with source metadata. Mirrors ``AgentVoiceConfigResponse``. ``source`` is ``"saved"`` when the team references a saved config via ``Team.voice_config_id``, or ``"inline"`` when using its own 1:1 row. Teams carry no first-speaking config (the greeting comes from the team's default member), so ``first_speaking_config`` is always ``None`` here. ``has_inline_fallback`` reports whether a team-owned inline row exists; the UI uses it to know whether unlinking is safe (the team falls back to its preserved inline config) or would leave the team with no voice config. ErrorResponse: properties: error: type: string title: Error message: type: string title: Message retryable: anyOf: - type: boolean - type: 'null' title: Retryable retry_after: anyOf: - type: integer - type: 'null' title: Retry After type: object required: - error - message title: ErrorResponse description: Standard error response returned by all API error handlers. HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError VoiceOut: properties: id: type: string format: uuid title: Id provider: type: string enum: - elevenlabs - inworld title: Provider external_id: type: string title: External Id name: type: string title: Name description: anyOf: - type: string - type: 'null' title: Description preview_url: anyOf: - type: string - type: 'null' title: Preview Url language: anyOf: - type: string - type: 'null' title: Language accent: anyOf: - type: string - type: 'null' title: Accent category: anyOf: - type: string - type: 'null' title: Category labels: additionalProperties: type: string type: object title: Labels supported_models: items: type: string type: array title: Supported Models is_active: type: boolean title: Is Active default: true created_at: type: string format: date-time title: Created At updated_at: type: string format: date-time title: Updated At type: object required: - id - provider - external_id - name - created_at - updated_at title: VoiceOut NoiseCancellationProvider: type: string enum: - rnnoise - dtln title: NoiseCancellationProvider description: >- Noise-suppression engine wired by ``audio_filters.build_audio_in_filter``. Applies only when ``noise_cancellation_enabled``. String values MUST match the provider strings the factory dispatches on. FirstSpeakingConfig: properties: first_speaker: type: string enum: - agent - user title: First Speaker default: agent mode: type: string enum: - static - dynamic title: Mode default: static text: anyOf: - type: string maxLength: 1000 - type: 'null' title: Text instructions: anyOf: - type: string maxLength: 2000 - type: 'null' title: Instructions interruptible: type: boolean title: Interruptible default: true ai_disclosure_text: anyOf: - type: string maxLength: 500 - type: 'null' title: Ai Disclosure Text type: object title: FirstSpeakingConfig description: |- Config for the AI's opening turn (no user input yet). Lives inside ``ChannelConfig`` — first-speaking is per-channel. Mode-agnostic fields: - ``first_speaker``: ``"agent"`` opens the call with the rendered message; ``"user"`` skips the greeting (caller speaks first). Non-voice channels treat the inbound user message as the ``"user"`` opener and ignore this field at runtime. Greeting source (only applies when ``first_speaker="agent"``): - ``static`` mode: ``text`` is required and emitted verbatim (templated via the shared ``{{var}}`` engine, ``src.shared.templating.render``). - ``dynamic`` mode: ``instructions`` are sent to the model router with the agent persona to render an opening line (instructions are templated). When omitted/empty, ``instructions`` falls back to ``DEFAULT_DYNAMIC_FIRST_SPEAKING_INSTRUCTIONS`` so operators who just want a generic friendly opener don't have to author copy. Voice-only fields (ignored on non-audio channels): - ``interruptible``: whether the caller can barge in mid-greeting. - ``ai_disclosure_text``: regulatory disclosure (e.g. CA SB 1001), played as an uninterruptible TTS frame BEFORE the greeting. Disclosure plays even when ``first_speaker="user"`` because the regulation requires the disclosure regardless of who speaks first. 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 securitySchemes: APIKeyHeader: type: apiKey in: header name: x-api-key ````