set_tool_category
Turns a group on or off.
The shell group is refused here. Only the operator can turn it on.
- Tool name
- set_tool_category
- Group
- Always on
- Risk
- medium
- Needs approval
- never
- Approval rule
- No approval. The shell group is operator-gated.
- Allowed in scheduled jobs
- No
- Default
- always on
Parameters
| Name | Type | Required | Default | Meaning | Limits |
|---|---|---|---|---|---|
| category | string | Yes | Which group of skills or tools. | ||
| enabled | boolean | Yes | True to turn the group on, false to turn it off. |
Returns
A confirmation.
Example (made up for this page)
{
"category": "demo",
"enabled": true
}Group web is now ON.Side effects
- Saves the choice to data.
How it can fail
| When | What the agent sees |
|---|---|
| Shell group | A refusal that it is operator-only |
| Unknown group | An error text |
See also:Tools
Checked against the source at commit f4fd89f on 29 Oct 2026. Everything here is merged on the main branch; no release has been tagged yet. The source is private, so these pages are the public description.