Agent Telephony
Replace agent telephony transfer targets
Replaces all transfer targets configured for the voice agent named in the path.
Header parameters
Foundry-Features
enum
A feature flag opt-in required when using preview operations or modifying persisted preview resources.
If-Match
string
required
The entity tag returned by the latest read. The request fails if the resource changed since that read.
Path parameters
agent_name
string
required
The name of the voice agent whose transfer targets are replaced.
Query parameters
api-version
string
required
The API version to use for this operation.
Request Body
transfer_targets
TelephonyTransferTarget[]
required
The complete set of destinations to which the voice agent may transfer calls. An empty array clears all targets when replacing the configuration.
Responses
The request has succeeded.
Headers
ETag
string
required
The entity tag to send in the If-Match header when replacing the transfer targets.
Body
transfer_targets
TelephonyTransferTarget[]
required
The complete set of destinations to which the voice agent may transfer calls. An empty array clears all targets when replacing the configuration.
Request
PUT /agents/{agent_name}/telephony/transfer_targets HTTP/1.1Response
Status: 200
Content-Type: application/jsonStatus: 4XX
Content-Type: application/jsonStatus: 5XX
Content-Type: application/json