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

## Changes

> 97 revisions in range; 1 not diffed, 14 could not be searched.

- **2026-06-05** `360eb26e3e6c` — 10 info
  - added the new optional request property `localized/additionalProperties/messages`
  - added the new optional request property `localized/additionalProperties/randomize_messages`
  - added the new optional request property `messages`
  - added the new optional request property `randomize_messages`
  - …6 more
- **2026-06-05** `500977ea342d` — 10 warning
  - removed the request property `localized/additionalProperties/messages`
  - removed the request property `localized/additionalProperties/randomize_messages`
  - removed the request property `messages`
  - removed the request property `randomize_messages`
  - …6 more
- **2026-06-04** `40af3baabe21` — 2 info
  - added the new optional request property `smart_turn_timeout_seconds`
  - added the optional property `smart_turn_timeout_seconds` to the response with the `200` status
- **2026-06-04** `8f8128319801` — 8 info
  - added the new optional request property `localized/additionalProperties/messages`
  - added the new optional request property `localized/additionalProperties/randomize_messages`
  - added the new optional request property `messages`
  - added the new optional request property `randomize_messages`
  - …4 more

[Change history](https://skmtc.dev/asksyllable/apis/syllablesdk/changes/api/v1/conversation-config/bridges/put.md)

---

[API](https://skmtc.dev/asksyllable/apis/syllablesdk.md) · [All operations](https://skmtc.dev/asksyllable/apis/syllablesdk/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/asksyllable/syllablesdk/revisions/203a46065323/schema)