DELETE

Remove Phone Numbers from Pool

Removes a phone number from the pool.

DELETEhttps://api.vantaxai.com/v1/number-pools/{pool_id}/members/{phone_number_id}

Removing a number only deletes its pool membership — the phone number itself remains in your sub-account and can be re-added later.

Headers

Authorizationstringrequired
Bearer authentication with your secret API key.
example: Bearer vx_live_3fa9c2…

Path Parameters

pool_idstringrequired
The pool that owns the membership.
example: pool_4c8e21
phone_number_idstringrequired
The phone number to remove from the pool.
example: pn_55ad12

Request

curl -X DELETE https://api.vantaxai.com/v1/number-pools/pool_4c8e21/members/pn_55ad12 \
  -H "Authorization: Bearer vx_live_3fa9c2..."

const res = await fetch(
  "https://api.vantaxai.com/v1/number-pools/pool_4c8e21/members/pn_55ad12",
  {
  method: "DELETE",
  headers: {
    Authorization: "Bearer vx_live_3fa9c2...",
  },
  }
);
const { data } = await res.json();

import { Vantax } from "@vantax/sdk";

const vantax = new Vantax({ apiKey: process.env.VANTAX_API_KEY! });
// DELETE /v1/number-pools/{pool_id}/members/{phone_number_id}
const result = await vantax.request("DELETE", "/v1/number-pools/{pool_id}/members/{phone_number_id}");

from vantax import Vantax

vantax = Vantax(api_key=os.environ["VANTAX_API_KEY"])
# DELETE /v1/number-pools/{pool_id}/members/{phone_number_id}
result = vantax.request("DELETE", "/v1/number-pools/{pool_id}/members/{phone_number_id}")

Response

{
  "success": true,
  "message": "Phone number removed from pool"
}

{ "success": false, "message": "Number is not in this pool" }