Skip to main content
POST
https://api.bland.ai
/
v1
/
blocked_numbers
/
{block_id}
/
edit
Edit Block Rule
curl --request POST \
  --url https://api.bland.ai/v1/blocked_numbers/{block_id}/edit \
  --header 'Content-Type: application/json' \
  --header 'authorization: <authorization>' \
  --data '
{
  "reason": "<string>",
  "is_active": true
}
'
{
  "data": {
    "id": 123,
    "blocked_number": "+10000000000",
    "is_global": false,
    "inbound_number": "+18888888888",
    "org_id": "b7d3e9fc-5c4a-4c2a-9b8f-d1e1d1a2e333",
    "reason": "User requested block",
    "is_active": false,
    "created_at": "2025-01-01T00:00:00.000Z",
    "updated_at": "2025-01-10T12:00:00.000Z"
  },
  "errors": null
}
You can only update fields like reason or is_active. Phone numbers and scope (global/inbound) are immutable after creation.

​
Headers

​
authorization
string
required
Your API key for authentication.

​
Path Parameters

​
block_id
number
required
The unique ID of the block rule to update.

​
Body Parameters

​
reason
string
Optional reason for blocking. Set to null to remove an existing reason.
​
is_active
boolean
Controls whether the block rule is currently enforced. Set to false to disable or true to re-enable. Use null to leave unchanged.

​
Response

​
data
object
The updated block rule object.
​
data.id
number
Unique ID of the block rule.
​
data.blocked_number
string
The phone number being blocked.
​
data.is_global
boolean
Indicates if the block applies globally.
​
data.inbound_number
string|null
The specific inbound number the block applies to (if not global).
​
data.org_id
string
UUID of the owning organization.
​
data.reason
string|null
Reason for the block, if present.
​
data.is_active
boolean
Whether the block rule is currently active.
​
data.created_at
string
ISO timestamp when the rule was created.
​
data.updated_at
string
ISO timestamp of the last update.
​
errors
null|array
null on success, or a list of validation or lookup errors.
{
  "data": {
    "id": 123,
    "blocked_number": "+10000000000",
    "is_global": false,
    "inbound_number": "+18888888888",
    "org_id": "b7d3e9fc-5c4a-4c2a-9b8f-d1e1d1a2e333",
    "reason": "User requested block",
    "is_active": false,
    "created_at": "2025-01-01T00:00:00.000Z",
    "updated_at": "2025-01-10T12:00:00.000Z"
  },
  "errors": null
}