POST
/
v1
/
geospatial-dialing-pools
/
{pool_id}
/
update
curl -X POST "https://us.api.bland.ai/v1/geospatial-dialing-pools/550e8400-e29b-41d4-a716-446655440001/update" \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phone_numbers": ["+12345678901", "+19876543210", "+15551234567", "+17775551234"],
    "encrypted_key": "550e8400-e29b-41d4-a716-446655440000"
  }'
{
  "status": "success",
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440001",
    "owner_id": "550e8400-e29b-41d4-a716-446655440002",
    "phone_numbers": ["+12345678901", "+19876543210", "+15551234567", "+17775551234"],
    "encrypted_key": "550e8400-e29b-41d4-a716-446655440000",
    "created_at": "2024-01-15T10:30:00Z"
  },
  "errors": null
}

Enterprise Feature - Geospatial dialing is only available on Enterprise plans. Contact your Bland representative for access.

Update an existing geospatial dialing pool by replacing its phone numbers and/or Twilio credentials. This operation will completely replace the existing phone numbers with the new ones provided.

​
Headers

​
authorization
string
required

Your API key for authentication.

​
Path Parameters

​
pool_id
string
required

The unique identifier (UUID) of the geospatial dialing pool to update.

Format: UUID format (e.g., 550e8400-e29b-41d4-a716-446655440000)

​
Body

​
phone_numbers
array
required

Array of phone numbers to replace the existing numbers in the pool. All numbers must be valid US phone numbers with +1 prefix.

Format: Each phone number must be exactly 12 characters: +1 followed by 10 digits.

Example: ["+12345678901", "+19876543210"]

This will completely replace all existing phone numbers in the pool. Any numbers not included in this array will be removed.

​
encrypted_key
string

Optional UUID of Twilio credentials to associate with this pool. If provided, must be valid credentials that belong to your account. To remove credentials, pass null.

Format: UUID format (e.g., 550e8400-e29b-41d4-a716-446655440000) or null

​
Response

​
status
string

Can be success or error.

​
data
object

The updated geospatial dialing pool object (present only if status is success).

​
errors
array

Array of error objects (present only if status is error).

curl -X POST "https://us.api.bland.ai/v1/geospatial-dialing-pools/550e8400-e29b-41d4-a716-446655440001/update" \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phone_numbers": ["+12345678901", "+19876543210", "+15551234567", "+17775551234"],
    "encrypted_key": "550e8400-e29b-41d4-a716-446655440000"
  }'
{
  "status": "success",
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440001",
    "owner_id": "550e8400-e29b-41d4-a716-446655440002",
    "phone_numbers": ["+12345678901", "+19876543210", "+15551234567", "+17775551234"],
    "encrypted_key": "550e8400-e29b-41d4-a716-446655440000",
    "created_at": "2024-01-15T10:30:00Z"
  },
  "errors": null
}

​
Removing Credentials

To remove Twilio credentials from a pool, set encrypted_key to null:

{
  "phone_numbers": ["+12345678901", "+19876543210"],
  "encrypted_key": null
}