microsoft-foundry.rest.security.o-auth2-auth
Agent Telephony
Get agent telephony transfer targets
GET
/agents/{agent_name}/telephony/transfer_targets
Returns 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.
VoiceAgents=V1Preview
Path parameters
agent_name
string
required
The name of the voice agent whose transfer targets are retrieved.
Query parameters
api-version
string
required
The API version to use for this operation.
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
Content-Type: application/json
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
GET /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