POST
/
v1
/
blocked_numbers
/
{block_id}
/
edit
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
}