Skip to main content
DELETE
Release a number

Authorizations

Authorization
string
header
required

An API key from Settings → API keys, sent as Authorization: Bearer kb_live_…. A workspace key starts kb_; a personal key starts kbp_ and acts as its owner.

Headers

Kallabot-Version
enum<string>

The API version to answer as, a date (YYYY-MM-DD). Leave it out for the current version (2026-11-07). An unknown version is refused with 400 unsupported_api_version.

Available options:
2026-11-07
Example:

"2026-11-07"

Path Parameters

number_id
string
required

Response

Successful Response

id
string
required

The number id.

e164
string
required

The number.

status
enum<string>
required

released now, or releasing (202) while the carrier finishes.

Available options:
released,
releasing