Agents API

Delete a single phone number

delete
https://api.dev.poly.ai/v1/agents/{agentId}/telephony/phone-numbers/{phoneNumber}

Path Parameters

agentIdstringrequired
phoneNumberstringrequired

Response

application/json

Successful response

DeletePhoneNumberResponse

The phone number that was released.

deletedstringrequired

The deleted phone number

delete/v1/agents/{agentId}/telephony/phone-numbers/{phoneNumber}
 
application/json

Reassign a phone number to a different connector

patch
https://api.dev.poly.ai/v1/agents/{agentId}/telephony/phone-numbers/{phoneNumber}

Path Parameters

agentIdstringrequired
phoneNumberstringrequired

Body

application/json

ReassignPhoneNumberBody

Target connector for reassigning a phone number.

connectorIdstringrequired

Target connector ID to reassign the phone number to

Response

application/json

Successful response

PhoneNumberResponse

A phone number owned by the project, plus the connector it routes incoming calls to.

numberstringrequired

Phone number in E.164 format

projectIdstringrequired

Project this number belongs to

accountIdstringrequired

Account this number belongs to

clientEnvstringrequired

Client environment (sandbox, pre-release, live)

connectorIdstring

Connector this number is routed to

patch/v1/agents/{agentId}/telephony/phone-numbers/{phoneNumber}

Body

{ "connectorId": "connectorId" }
 
application/json

ActiveDeploymentsResponse

object

The latest deployment for each environment (sandbox, pre-release,
live). Entries are null when no deployment exists for an environment.

activeDeploymentsobjectrequired

Latest deployment per environment (sandbox, pre-release, live). Value is null if no deployment exists for that environment.

Example

AgentRulesResponse

object
* Additional properties are NOT allowed.
behaviorstringrequired
Example

AttributeResponse

object
* Additional properties are NOT allowed.
idstringrequired
namestringrequired
Example