API Reference
API Reference

Update Bridge Phrases Config

Update the bridge phrases configuration.

PUT/api/v1/conversation-config/bridges

Authentication

Syllable-API-Keyrequired

Send Syllable-API-Key in the header.

Need a credential? Create or manage an API token in the Syllable Console.

Parameters

Query parameters

agent_id integer | null query optional

Agent ID to update config for

tool_name string | null query optional

Tool name to update config for

Request body

application/json

body BridgePhrasesConfig required
7 fields
messagesstring[]optional

Unified ordered bridge phrases. If empty, legacy fields are used.

Item schema
itemsstringrequired
randomize_messagesbooleanoptional

When true, unified messages are played in randomized no-repeat cycles. Ignored when unified messages are disabled.

Default false
first_slow_messagesstring[]optional

Messages to say when the agent is first delayed.

Item schema
itemsstringrequired
very_slow_messagesstring[]optional

Messages to say when the agent is significantly delayed.

Item schema
itemsstringrequired
tool_responsesstring[]optional

Messages to say when a tool call is in progress.

Item schema
itemsstringrequired
localizedobjectoptional

Per-language overrides keyed by BCP-47 tag (e.g. "es-US").

1 field
{key}schemas__cortex__v1__bridge_phrases__BridgePhraseMessagesoptional

Bridge phrase message lists for a single language.

5 fields
messagesstring[]optional

Unified ordered bridge phrases. If empty, legacy fields are used.

Item schema
itemsstringrequired
randomize_messagesbooleanoptional

When true, unified messages are played in randomized no-repeat cycles. Ignored when unified messages are disabled.

Default false
first_slow_messagesstring[]optional

Messages to say when the agent is first delayed.

Item schema
itemsstringrequired
very_slow_messagesstring[]optional

Messages to say when the agent is significantly delayed.

Item schema
itemsstringrequired
tool_responsesstring[]optional

Messages to say when a tool call is in progress.

Item schema
itemsstringrequired
smart_turn_timeout_secondsnumber | nulloptional

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.

Minimum 0.25Maximum 30
Request example
{
  "messages": [
    "string"
  ],
  "randomize_messages": false,
  "first_slow_messages": [
    "string"
  ],
  "very_slow_messages": [
    "string"
  ],
  "tool_responses": [
    "string"
  ],
  "localized": "string",
  "smart_turn_timeout_seconds": "string"
}

Responses

200Successful Response

application/json

response BridgePhrasesConfig required
7 fields
messagesstring[]optional

Unified ordered bridge phrases. If empty, legacy fields are used.

Item schema
itemsstringrequired
randomize_messagesbooleanoptional

When true, unified messages are played in randomized no-repeat cycles. Ignored when unified messages are disabled.

Default false
first_slow_messagesstring[]optional

Messages to say when the agent is first delayed.

Item schema
itemsstringrequired
very_slow_messagesstring[]optional

Messages to say when the agent is significantly delayed.

Item schema
itemsstringrequired
tool_responsesstring[]optional

Messages to say when a tool call is in progress.

Item schema
itemsstringrequired
localizedobjectoptional

Per-language overrides keyed by BCP-47 tag (e.g. "es-US").

1 field
{key}schemas__cortex__v1__bridge_phrases__BridgePhraseMessagesoptional

Bridge phrase message lists for a single language.

5 fields
messagesstring[]optional

Unified ordered bridge phrases. If empty, legacy fields are used.

Item schema
itemsstringrequired
randomize_messagesbooleanoptional

When true, unified messages are played in randomized no-repeat cycles. Ignored when unified messages are disabled.

Default false
first_slow_messagesstring[]optional

Messages to say when the agent is first delayed.

Item schema
itemsstringrequired
very_slow_messagesstring[]optional

Messages to say when the agent is significantly delayed.

Item schema
itemsstringrequired
tool_responsesstring[]optional

Messages to say when a tool call is in progress.

Item schema
itemsstringrequired
smart_turn_timeout_secondsnumber | nulloptional

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.

Minimum 0.25Maximum 30
Response example
{
  "messages": [
    "string"
  ],
  "randomize_messages": false,
  "first_slow_messages": [
    "string"
  ],
  "very_slow_messages": [
    "string"
  ],
  "tool_responses": [
    "string"
  ],
  "localized": "string",
  "smart_turn_timeout_seconds": "string"
}
422Validation Error

application/json

response HTTPValidationError required
1 field
detailValidationError[]optional
Item schema
itemsValidationErrorrequired
3 fields
locstring | integer[]required
Item schema
itemsstring | integerrequired
2 options
Option 1stringrequired
Option 2integerrequired
msgstringrequired
typestringrequired
Response example
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}