Docs
Numbersv4

Release a number

DELETE/numbers/{number}

Give a number up. A Blooio SMS or Blooio Voice number is released to the carrier at once and its channels retired; number.removed fires for each channel. An iMessage line is removed the same way as DELETE /channels/{channel}. OAuth apps need numbers:manage.

Path parameters

numberRequiredstring

The number in E.164 format, with + URL-encoded as %2B (e.g. %2B15551234567).

Headers

AuthorizationRequiredstring

Your API key, sent as a bearer token: Authorization: Bearer <api_key>. Editing this stays in sync with the API key box on the right.

Bearer

Returns

dataoptionalReleasedNumber

A released Blooio SMS or Blooio Voice number. Releasing an iMessage line returns the same response as DELETE /channels/{channel} instead.

numberRequiredstring

The released number in E.164 format.

channel_idsRequiredstring[]

The channels retired with it.

Response codes

200The released number
400`invalid_number`.
401Your API key is missing or invalid. Pass it as a bearer token.
403`feature_not_enabled`: Blooio SMS and Blooio Voice aren't enabled on this organization.
404`number_not_found`.
502`upstream_unavailable`: the carrier network couldn't be reached. Retry with backoff.

Sends a live request with your values and shows the real response below. Your key is stored only in this browser.

Request
curl -X DELETE https://api.blooio.com/v4/numbers/%2B15551234567 \
Response objectexample
{  "data": {    "number": "+15551234567",    "channel_ids": [      "string"    ]  }}