Update Phone Number
PUT
/api/partner/v2/phone_numbers/{id}
const url = 'https://api.linqapp.com/api/partner/v2/phone_numbers/1';const options = { method: 'PUT', headers: { 'X-LINQ-INTEGRATION-TOKEN': '<X-LINQ-INTEGRATION-TOKEN>', 'Content-Type': 'application/json' }, body: '{"forwarding_number":"+15551234567"}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request PUT \ --url https://api.linqapp.com/api/partner/v2/phone_numbers/1 \ --header 'Content-Type: application/json' \ --header 'X-LINQ-INTEGRATION-TOKEN: <X-LINQ-INTEGRATION-TOKEN>' \ --data '{ "forwarding_number": "+15551234567" }'Updates the forwarding number for a phone number. The forwarding number is where calls will be forwarded to when the primary number is unavailable.
Pass an empty string to clear the forwarding number.
Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters ” id
required
integer
The phone number ID
Request Body required
Section titled “Request Body required ” Media type application/json
object
forwarding_number
The phone number to forward calls to when unavailable (pass empty string to clear)
string
Example
+15551234567Responses
Section titled “ Responses ”Phone number updated successfully
Media type application/json
object
id
integer
phone_number
string
forwarding_number
Phone number where calls are forwarded when this number is unavailable
string
response_rate
Response rate as messages per second
integer
Example
{ "id": 99, "phone_number": "+19498151221", "forwarding_number": null, "response_rate": 75}Forbidden - Phone number doesn’t belong to your organization
Media type application/json
Standard error format used by most endpoints (render_error format)
object
errors
Array<object>
object
status
integer
code
string
title
string
detail
string
Example
{ "errors": [ { "status": 403, "code": "forbidden", "title": "Forbidden", "detail": "This phone number doesn't belong to your organization" } ]}Unprocessable entity - Invalid forwarding number
Media type application/json
Standard error format used by most endpoints (render_error format)
object
errors
Array<object>
object
status
integer
code
string
title
string
detail
string
Example
{ "errors": [ { "status": 422, "code": "invalid_request", "title": "Invalid Request", "detail": "Forwarding number is invalid" } ]}