Revoke a principal's access
revoke_principalDisable a principal to immediately invalidate its API key; this is irreversible, and erase=true hard-deletes the principal row instead of retaining it as disabled.
Instructions
Admin only. Disable a principal — its API key stops working immediately. Irreversible
(create a new principal to restore access). With erase=True, the principal row is HARD-deleted
(Art. 17 for team members) instead of retained as disabled. A tenant admin can only revoke its
own tenant's principals; another tenant's id reads as unknown.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"principal_id": "<principal_id>"
},
"name": "revoke_principal"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| erase | No | ||
| principal_id | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |