Skip to main content
POST
/
utils
/
twilio
/
release-number
Release a Twilio number
curl --request POST \
  --url https://eu-gcp-api.vg-stuff.com/v3/utils/twilio/release-number \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "workspaceId": "<string>",
  "phoneNumberSid": "<string>",
  "isImportedNumber": true
}
'
{
  "isGood": true,
  "errors": "<string>"
}
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. 
curl -X POST "https://eu-gcp-api.vg-stuff.com/v3/utils/twilio/release-number" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "phoneNumberSid": "PNxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx", "isImportedNumber": false }'
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