organization_principal-grants_revoke

Tool

Takes tools away from a delegated principal; omit tools to take away everything it holds (product owner/admin)

Name	Type	Required	Description
tools	array	—	No description in the catalog.
reason	string	—	No description in the catalog.
productId	string	•	No description in the catalog.
principalId	string	•	No description in the catalog.
principalKind	string	•	No description in the catalog.

Field	Type	Always
grants	array	•
pending	array	•
effective	array	•
productId	string	•
principalId	string	•
needsSponsor	array	•
principalKind	string	•

Takes tools away from a delegated principal; omit tools to take away everything it holds (product owner/admin).

When to use

Takes tools away from a delegated principal; omit tools to take away everything it holds (product owner/admin)

Ask your agent something like this:

Takes tools away from a delegated principal; omit tools to take away everything it holds (product owner/admin).

The agent will invoke organization_principal-grants_revoke with these arguments:

{
  "productId": "<productId>",
  "principalId": "<principalId>",
  "principalKind": "<principalKind>"
}