---
title: "Update Bridge Phrases Config"
method: PUT
path: "/api/v1/conversation-config/bridges"
tags: ["conversation-config"]
---

# Update Bridge Phrases Config

`PUT /api/v1/conversation-config/bridges`

Update the bridge phrases configuration.

## Query parameters

- `agent_id` integer, nullable — Agent ID to update config for
- `tool_name` string, nullable — Tool name to update config for

## Request body

- BridgePhrasesConfig — Configuration for conversational bridge phrases. Top-level fields are the default (English) phrases. The `localized` dict provides per-language overrides keyed by BCP-47 language tag.
  - `messages` string[] — Unified ordered bridge phrases. If empty, legacy fields are used.
  - `randomize_messages` boolean — When true, unified messages are played in randomized no-repeat cycles. Ignored when unified messages are disabled.
  - `first_slow_messages` string[] — Messages to say when the agent is first delayed.
  - `very_slow_messages` string[] — Messages to say when the agent is significantly delayed.
  - `tool_responses` string[] — Messages to say when a tool call is in progress.
  - `localized` object — Per-language overrides keyed by BCP-47 tag (e.g. "es-US").
  - `smart_turn_timeout_seconds` number, nullable — Seconds of caller silence before injecting the first bridge phrase. Subsequent sleep intervals are 2x, 3x, 4x this base. When unset, the service-wide default applies.

## Response `200`

Successful Response

- BridgePhrasesConfig — Configuration for conversational bridge phrases. Top-level fields are the default (English) phrases. The `localized` dict provides per-language overrides keyed by BCP-47 language tag.
  - `messages` string[] — Unified ordered bridge phrases. If empty, legacy fields are used.
  - `randomize_messages` boolean — When true, unified messages are played in randomized no-repeat cycles. Ignored when unified messages are disabled.
  - `first_slow_messages` string[] — Messages to say when the agent is first delayed.
  - `very_slow_messages` string[] — Messages to say when the agent is significantly delayed.
  - `tool_responses` string[] — Messages to say when a tool call is in progress.
  - `localized` object — Per-language overrides keyed by BCP-47 tag (e.g. "es-US").
  - `smart_turn_timeout_seconds` number, nullable — Seconds of caller silence before injecting the first bridge phrase. Subsequent sleep intervals are 2x, 3x, 4x this base. When unset, the service-wide default applies.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/asksyllable/apis/syllablesdk.md) · [All operations](https://skmtc.net/asksyllable/apis/syllablesdk/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/asksyllable/syllablesdk/versions/ac3228f980bb/schema)