Skip to main content
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
}

Documentation Index

Fetch the complete documentation index at: https://blandai-calvin-pronunciationguide-web.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

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
}