consent/list-banners lists the consent banners configured on the site, with which one is active and which is the default.
A site normally has one per privacy law it answers to, and the active one decides what visitors are shown.
At a glance
| Ability | consent/list-banners |
| Toolset | CookieYes — toolset/cookieyes |
| Group | CookieYes › The Banner |
| Requires | CookieYes, active on the site |
| Capability | manage_options |
| Safety | Read-only — changes nothing |
| Repeatable | Idempotent — running it twice leaves the same result |
| Ships in | AcrossAI Abilities Manager 0.0.34 and later |
How it works
The plugin models this as several banner configurations of which one is live, rather than one banner that gets edited. That is because the requirements genuinely differ by jurisdiction — opt-in before loading in one place, opt-out disclosure in another — and they are not reconcilable into a single set of options.
The consequence worth knowing: editing categories and cookies changes what every banner reports, while which banner is active changes how the choice is put. A change that looks like it did nothing may have landed on a banner that is not the live one.
This ability reads. Switching the active banner is a jurisdiction decision and is not exposed in this suite.
Input
This ability takes no input.
What comes back
| Name | Type | What it is |
|---|---|---|
banners | array | One entry per banner: ID, name, active flag and default flag. |
count | integer | How many banners are configured. |
success | boolean | Whether the call completed. |
message | string | A one-line summary of what happened, suitable for showing a human. |
error_code | string | Present only on failure — a stable machine-readable reason, such as a missing field, a wrong field type or an unmet confirmation. |
Example
Ask your assistant:
Which cookie banner is live on this site?
It resolves to one call:
{
"ability": "consent/list-banners",
"parameters": {}
}Worth knowing
- Only the active banner is served to visitors.
- Which privacy law the site answers to is not changeable through this suite.
Related abilities
- Get Consent Banner — one banner in full
- Get Banner Status — what visitors are actually receiving
Get the plugins:
AcrossAI Abilities Manager · AcrossAI MCP Manager
Browse the rest: Every ability, by category