Skip to main content
POST
/
release-phone-number
curl -X POST https://api.magpipe.ai/functions/v1/release-phone-number \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"number_id": "a1b2c3d4-5678-9012-3456-789012345678"}'

{
  "success": true,
  "phone_number": "+16045551234"
}
Release a phone number from your account. The number will be returned to the available pool and can no longer be used for calls or messages.
This action is irreversible. The number will be immediately released and you may not be able to re-acquire the same number.

​
Request Body

​
number_id
string
required
The unique identifier of the phone number to release.

​
Response

​
success
boolean
Whether the number was released successfully.
​
phone_number
string
The released phone number.
curl -X POST https://api.magpipe.ai/functions/v1/release-phone-number \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"number_id": "a1b2c3d4-5678-9012-3456-789012345678"}'

{
  "success": true,
  "phone_number": "+16045551234"
}