Skip to main content
PUT
/
assistants
/
v1
/
numbers
/
{id}
Update Number
curl --request PUT \
  --url https://api-prod.interactly.ai/assistants/v1/numbers/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "assistantId": "a12f9c88-c155-461f-9771-4d240cdc9a04",
  "inboundEnabled": true,
  "outboundEnabled": true
}
'
{
  "_id": "a12f9c88-c155-461f-9771-4d240cdc9a04",
  "teamId": "1f7b1b1b1b1b1b1b1b1b1b1b",
  "number": "+1234567890",
  "provider": {
    "name": "twilio"
  },
  "assistantId": "a12f9c88-c155-461f-9771-4d240cdc9a04",
  "inboundEnabled": true,
  "outboundEnabled": true,
  "label": "friendly-name-1"
}

Authorizations

Authorization
string
header
required

Retrieve your API Key from Dashboard API Keys Section.

Path Parameters

id
string
required

The ID of the number to update.

Body

application/json
assistantId
string

To attach assistant, give id of the assistant. To detach assistant, give empty string.

Example:

"a12f9c88-c155-461f-9771-4d240cdc9a04"

inboundEnabled
boolean

To enable inbound call, set to true. To disable inbound call, set to false.

Example:

true

outboundEnabled
boolean

To enable outbound call, set to true. To disable outbound call, set to false.

Example:

true

Response

Successfully updated the number.

_id
string<objectId>
required

Unique identifier of the number

Example:

"a12f9c88-c155-461f-9771-4d240cdc9a04"

teamId
string<objectId>
required

This is unique identifier of the team.

Example:

"1f7b1b1b1b1b1b1b1b1b1b1b"

number
string
required

Phone number associated with the team

Example:

"+1234567890"

provider
object
required
assistantId
string

ID of the associated assistant (if any)

Example:

"a12f9c88-c155-461f-9771-4d240cdc9a04"

inboundEnabled
boolean

If true, inbound call is enabled. If false, inbound call is disabled.

Example:

true

outboundEnabled
boolean

If true, outbound call is enabled. If false, outbound call is disabled.

Example:

true

label
string

Label for the number

Example:

"friendly-name-1"