# boolean_smtp_rest_capability

> Filters the capability required to use the BooleanSMTP REST API.

Filter · Tier A · Since 1.0.0

Applies to every route except the public provider webhook. Defaults to `manage_options`; return a finer capability to delegate the admin UI to another role.

## Signature

```php
add_filter( 'boolean_smtp_rest_capability', $callback, 10, 1 );
```

## Parameters

| Name | Type | Description |
| --- | --- | --- |
| `$capability` | `string` | The WordPress capability. Default `manage_options`. |

**Returns** `string` — The filtered capability.

## Fires in

- [app/Providers/RouteServiceProvider.php:102](https://github.com/booleanpress/boolean-smtp-src/blob/main/app/Providers/RouteServiceProvider.php#L102) — `BooleanSmtp\Providers\RouteServiceProvider::capability()`
- [boolean-smtp-pro/app/Providers/ProRouteServiceProvider.php:45](https://github.com/booleanpress/boolean-smtp-src/blob/main/boolean-smtp-pro/app/Providers/ProRouteServiceProvider.php#L45) — `BooleanSmtpPro\Providers\ProRouteServiceProvider::router()`

## Example

```php
add_filter( 'boolean_smtp_rest_capability', function ( string $capability ) {
    return $capability;
}, 10, 1 );
```