v4

latestOpenAPI 3.1.02026-08-0255174167.5 KB
phoneNumbers

Release a phone number

Release a number — standard SMS/call or iMessage. Immediate and irreversible.

On a flat-rate subscription, releasing a number lowers the subscription quantity by one and Stripe prorates the change — but the quantity never falls below one number. Releasing your last number therefore leaves the subscription active at the single-number rate rather than cancelling it, and the next number you provision is free (see Provision a phone number). To stop paying entirely, cancel the subscription with Cancel the subscription at period end.

delete/api/v1/numbers/{id}

Path parameters

idstring required

Headers

Authorizationstring required

Your Dial API key, sent as Authorization: Bearer sk_live_...

Response

Released.

successboolean