Remove a Voice Route for a Phone Number

Remove an inbound route association from one of your long code or toll-free phone numbers.

Endpoint

DELETE /numbers/:id/relationships/:route_type

Path Parameter

  • number_id
    string REQUIRED

    The phone number from which the route for voice will be removed. This number must be in 11-digit North American format. e.g. 12065551234.

  • route_type
    string REQUIRED

    Which route type to remove. This must be either primary_route or failover_route.

Response

On success, the HTTP status code in the response header is 204 NO CONTENT which means that the server successfully processed the request and is not returning any content. On error, the header status code is an error code and the response body contains an array of error objects.


Example Request

DELETE /v2/numbers/12013451234/relationships/failover_route HTTP/1.1
Content-Type: application/vnd.api+json
Accept: application/vnd.api+json

Example Request

curl https://api.flowroute.com/v2/numbers/12013451234/relationships/failover_route -X DELETE \
-u accessKey:secretKey -H 'Content-Type':'application/vnd.api+json'

Example Responses

204 NO CONTENT (Success)

401 Unauthorized

{
  "errors": [
    {
      "detail": "Authentication failed.",
      "id": "7fc8c70a-ca58-430c-b383-b89df84f8083",
      "status": 401,
      "title": "Unauthorized"
    }
  ]
}

403 Forbidden

{  "errors": 
  [
    {
      "status": 403, 
      "detail": "", 
      "title": "ActionNotAuthorizedError"
    }
  ]
}