Skip to content
Vocapable Developers

Remove a number's answering policy and return it to the agent route

DELETE
/v1/phone-numbers/{number_id}/answering-policy
curl --request DELETE \
  --url https://api.vocapable.com/v1/phone-numbers/example/answering-policy \
  --header 'Authorization: Bearer <token>'

Delete the document and restore the agent route the number had before.

Deliberately not gated on carrier eligibility or on a live key. This is the only way to disarm a policy route, and the safe way to turn a route off must never depend on the carrier account still verifying - the same rule the legacy clear already follows.

The route is only moved when the number is actually on policy: a number a later inbound-voice-routing PATCH already returned to an agent keeps that agent instead of having it silently cleared by this call.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
number_id
required
Number Id
string

Responses

Section titled “Responses”

204

Section titled “204”

Successful Response

422

Section titled “422”

Validation Error

Media typeapplication/json
HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
input
Input
ctx
Context
object
Examplegenerated
{
  "detail": [
    {
      "loc": [
        "example"
      ],
      "msg": "example",
      "type": "example",
      "input": "example",
      "ctx": {}
    }
  ]
}