Agent Telephony
Update an agent telephony binding
Updates a telephony binding owned by the voice agent named in the path. Updating a SIP binding requires the VoiceAgents=V1Preview opt-in.
標頭參數
Foundry-Features
enum
A feature flag opt-in required when using preview operations or modifying persisted preview resources.
If-Match
string
必要
The entity tag returned by the latest read. The request fails if the resource changed since that read.
路徑參數
agent_name
string
必要
The name of the voice agent that owns the binding.
binding_id
string
必要
The service-generated binding identifier.
查詢參數
api-version
string
必要
The API version to use for this operation.
要求本文
The binding properties to update.
label
string | null
Replacement label: omit to preserve, null/blank to clear. Trimmed before length validation.
connection_name
string
Replacement same-project connection for Teams or SIP (SipInbound only); immutable for Twilio. Null/blank names are invalid.
phone_number
string | null
Teams/SIP display number, not SIP routing. Omit to preserve; null/empty/blank clears. Unsupported for Twilio.
allowed_calling_numbers
SipAllowedCallingNumber[]
SIP caller restrictions: omit to preserve, [] to clear; null is invalid. Network restrictions belong to the connection.
回覆
The request has succeeded.
標題
ETag
string
必要
The entity tag to send in the If-Match header when updating or deleting the binding.
主體
teams_phone_extensibility
TeamsPhoneExtensibilityTelephonyBinding
A Microsoft Teams Phone extensibility binding owned by a voice agent.
provider
enum
必要
The Microsoft Teams Phone extensibility provider.
phone_number
string
The optional display phone number for the Teams resource account.
resource_account_object_id
string
必要
Universally Unique Identifier
twilio
TwilioTelephonyBinding
A Twilio binding owned by a voice agent.
provider
enum
必要
The Twilio provider.
phone_number
string
必要
The Twilio E.164 phone number.
sip
SipTelephonyBinding
Inbound binding using a same-project SipInbound connection for authentication/network restrictions. Creation does not prove regional runtime readiness.
provider
enum
必要
The SIP provider.
phone_number
string
Optional display metadata, not a routing key or E.164-constrained destination.
allowed_calling_numbers
SipAllowedCallingNumber[]
Exact E.164 caller numbers or restricted anchored patterns, validated by the service. Omit or use [] for no restriction.
Request
PATCH /agents/{agent_name}/telephony/bindings/{binding_id} HTTP/1.1
回應
Status: 200
Content-Type: application/json
Status: 4XX
Content-Type: application/json
Status: 5XX
Content-Type: application/json