Skip to main content
POST
Release a Twilio number
For numbers purchased via /utils/buy-twilio-number (isImportedNumber: false), this endpoint also releases the number on the platform’s Twilio account, freeing up the slot. For imported numbers (isImportedNumber: true), the number is only removed from Convocore — your own Twilio account keeps it.
Releasing a platform-rented number is permanent — Twilio cannot guarantee you’ll be able to reclaim the same number afterwards.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
workspaceId
string
required
phoneNumberSid
string
required
isImportedNumber
boolean
required

Response

Successful response

isGood
boolean
required
errors
string
required