Assign phone number
PUT
Assign phone number

Authorizations

Authorization
string
header
required

Voiceflow bearer token

Path Parameters

phoneNumberID
string
required

Query Parameters

workspaceID
string
required

The ID of the workspace the number belongs to.

Body

target
enum<string>
required

Which side of the number to point at the project: voice for incoming calls, sms for incoming SMS. The other side is left as it was.

Available options: sms, voice
version
enum<string>

Which version of the environment answers: published, the one serving live traffic, or draft, the working copy. Requires environmentAlias. Defaults to published.

Available options: draft, published
projectID
string
required

The ID of the project the number should reach.

environmentAlias
string

The alias of the environment that should answer (e.g. main). Omit it to assign the number to the project without pinning an environment, which also clears a pin a previous assign set.

Response

200 - application/json

Confirms the phone number was assigned. The body is a message only, so refetch the phone number to see the voice or sms target it now answers as.

message
string
required

A human-readable message confirming the update.

Use the up and down arrow keys to select a result, Enter to open it, and Escape to close the search.