consent/get-category reads one consent category and the cookies declared under it, in a single call.
It is the audit view: the choice a visitor is offered, next to what accepting it actually permits.
At a glance
| Ability | consent/get-category |
| Toolset | CookieYes — toolset/cookieyes |
| Group | CookieYes › Consent Categories |
| 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
Reading a category on its own tells you what the banner says. Reading it with its cookies tells you what the banner means, and those come apart more often than you would think — an analytics category whose only declared cookie is a session identifier, a marketing category with nothing in it.
The category’s name and description come back keyed by language, so missing translations are visible here too.
The strictly necessary flag is read-only everywhere in this suite. It is the flag that decides whether a category loads before any consent is given, and changing it turns a real choice into a non-choice — a decision that belongs to a person on the settings screen.
Input
| Name | Type | Required | What it is |
|---|---|---|---|
id | integer | Yes | Category ID, from consent/list-categories. |
What comes back
| Name | Type | What it is |
|---|---|---|
category | object | ID, name and description keyed by language, strictly-necessary flag, visibility and priority. |
cookies | array | The cookies declared under this category. |
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:
What is in our analytics consent category?
It resolves to one call:
{
"ability": "consent/get-category",
"parameters": {
"id": 3
}
}Worth knowing
- The strictly necessary flag is readable here and not writable anywhere in this suite.
- An empty category is a choice about nothing.
Related abilities
- Update Consent Category — change its presentation
- List Declared Cookies — the full inventory
Get the plugins:
AcrossAI Abilities Manager · AcrossAI MCP Manager
Browse the rest: Every ability, by category