Agent Telephony

Update an agent telephony binding

PATCH /agents/{agent_name}/telephony/bindings/{binding_id}

Updates a telephony binding owned by the voice agent named in the path.

Parametri di intestazione

Foundry-Features enum

A feature flag opt-in required when using preview operations or modifying persisted preview resources.

VoiceAgents=V1Preview

If-Match string necessario

The entity tag returned by the latest read. The request fails if the resource changed since that read.

Parametri del percorso

agent_name string necessario

The name of the voice agent that owns the binding.

binding_id string necessario

The service-generated binding identifier.

Parametri di query

api-version string necessario

The API version to use for this operation.

Corpo della richiesta

The binding properties to update.

Content-Type: application/merge-patch+json

status string | enum

The lifecycle status of a telephony binding.

Uno qualsiasi dei seguenti:

string

enum

activesuspended

label string | null

The replacement display label. Omit it to preserve the current value; use null to clear it.

connection_name string

The replacement Foundry connection name. This property is valid only for a Teams Phone Extension binding; a Twilio binding's connection is immutable.

phone_number string | null

The replacement Teams Phone Extension display phone number. Omit it to preserve the current value; use null to clear it. This property is valid only for a Teams Phone Extension binding.

Risposte

The request has succeeded.

Intestazioni

ETag string necessario

The entity tag to send in the If-Match header when updating or deleting the binding.

Corpo

Content-Type: application/json

Uno dei seguenti:

teams_phone_extension TeamsPhoneExtensionTelephonyBinding

A Microsoft Teams Phone Extension binding owned by a voice agent.

provider enum necessario

The Microsoft Teams Phone Extension provider.

teams_phone_extension

phone_number string

The optional display phone number for the Teams resource account.

resource_account_object_id string necessario

Universally Unique Identifier

twilio TwilioTelephonyBinding

A Twilio binding owned by a voice agent.

provider enum necessario

The Twilio provider.

twilio

phone_number string necessario

The Twilio E.164 phone number.

Richiedi

PATCH /agents/{agent_name}/telephony/bindings/{binding_id} HTTP/1.1

Response

Status: 200
Content-Type: application/json

Status: 4XX
Content-Type: application/json

Status: 5XX
Content-Type: application/json