Phone numbers

Make a number the caller ID for outbound calls

Binds an already-owned number as what the company presents when it calls out. Exactly one number can hold this, so the previous default loses it in the same step — there is no separate call to clear it, and no way through this API to end up with none once one has been chosen. Idempotent: repeating it on the same number changes nothing. Free and reversible; the money was spent when the number was bought. A number that is suspended or still awaiting provider confirmation is refused, because a caller ID that cannot carry calls breaks every outbound call at once. PATCH is accepted on the same path with identical semantics.

put/api/v1/phone-numbers/{did}/default

Request

Base URL: https://wardenpoint.com (the document declares no server; this is the origin it was published from)
URL: https://wardenpoint.com/api/v1/phone-numbers/{did}/default
Auth: API key in header X-API-Key

Path parameters

didstring uuid required

Phone number UUID.

Response

The number, now default.

Example response

{
  "data": {
    "number": "+48221234567",
    "country_code": "PL",
    "currency": "USD"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.