---
title: "fswa_ability_permitted — Filter Hook"
description: "Filters whether the current request may invoke a Webhook Actions ability through the Abilities API surface."
url: "https://wpwebhooks.org/docs/fswa-ability-permitted/"
---

[WP Webhooks](/) / [Docs](/docs/) / fswa\_ability\_permitted

Filter since v2.0.0

# fswa\_ability\_permitted

Filters whether the current request may invoke a Webhook Actions ability through the Abilities API surface.

/ Signature

```
apply_filters( 'fswa_ability_permitted', $allowed, $scope )
```

/ When it fires

Fires as the permission callback whenever an ability is invoked through the WordPress Abilities API (including MCP adapters). The in-admin Build with AI panel uses its own admin gate and does not pass through this filter.

/ Parameters

| Name | In | Type | Req | Description |
| --- | --- | --- | --- | --- |
| $allowed | param | bool | yes | Whether access is granted. Default: current user has \`manage\_options\`. |
| $scope | param | string | yes | Required registry scope for the ability: \`read\` or \`full\`. |

/ Returns

`bool` Whether the ability may run for this request.

/ Examples

Allow editors to run read-scope abilities

```
add_filter( 'fswa_ability_permitted', function ( $allowed, $scope ) {
    if ( 'read' === $scope && current_user_can( 'edit_others_posts' ) ) {
        return true;
    }
    return $allowed;
}, 10, 2 );
```

/ Related

[Build with AI](/docs/build-with-ai/)[fswa\_ability\_definitions](/docs/fswa-ability-definitions/)

/Ready

## Your next automation is  
one sentence away.

[Install Plugin→](https://wordpress.org/plugins/flowsystems-webhook-actions/) [See the Plugin →](/wordpress-webhook-plugin/)

$ wp plugin install flowsystems-webhook-actions --activate

## Structured data

```json
{"@context":"https://schema.org","@type":"TechArticle","name":"fswa_ability_permitted — Filter Hook — Webhook Actions Docs","description":"Filters whether the current request may invoke a Webhook Actions ability through the Abilities API surface.","url":"https://wpwebhooks.org/docs/fswa-ability-permitted/","isPartOf":{"@type":"WebSite","name":"WP Webhooks","url":"https://wpwebhooks.org"},"about":{"@type":"SoftwareApplication","name":"Webhook Actions","applicationCategory":"WordPress Plugin"}}
```