> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bland.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Edit Block Rule

> Update attributes of an existing block rule.

> [!NOTE]
>
> 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.

```json Response theme={null}
{
  "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
}
```

***

Docs for agents: [llms.txt](https://docs.bland.ai/llms.txt)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.