Skip to main content
POST
Revoke skill grants from agents in bulk — the retirement counterpart of grant-batch. Same axes (--agent/--all-agents × --skill/--all-skills). Use --dry-run to preview.

Body

application/json
agent
string

Target a single agent (mutually exclusive with --all-agents)

allAgents
boolean

Target every agent in the fleet

allSkills
boolean

Target every catalog + installed skill

dryRun
boolean

Preview counts without removing any grant

skill
string

Target a single skill (mutually exclusive with --all-skills)

Response

Success — body conforms to the @Returns schema.

agentsTargeted
number
required
dryRun
boolean
required
errors
object[]
required
op
enum<string>
required
Available options:
grant,
revoke
pairsAffected
number
required
pairsSkipped
number
required
sampleAgents
string[]
required
sampleSkills
string[]
required
skillsTargeted
number
required