Skip to main content
POST
Grant skills to agents in bulk. Reuses the per-agent grant mechanism across many (agent, skill) pairs in one call. Idempotent (upsert). 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 writing any grant

note
string

Optional operator note stamped on every 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