query_security_principals
Query visible users, teams, or roles with ID, name, type, and business-unit filters to inspect security principals; bounded results do not imply effective record permissions.
Instructions
Read bounded visible users, teams or roles with optional ID/name/business-unit filters. Disabled users are included unless enabled is explicit. Catalog entries do not imply effective record permissions.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "query_security_principals"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| top | No | Maximum visible rows, default 50. Reaching this bound is not a complete inventory. | |
| enabled | No | Only systemuser: explicit enabled/disabled filter. | |
| maxPages | No | Compatibility alias for max_pages; conflicting values are rejected. | |
| max_pages | No | Maximum native pages, default 5. Bounded reads report incompleteness. | |
| nameKeyword | No | Compatibility alias for name_keyword; conflicting values are rejected. | |
| principalId | No | Compatibility alias for principal_id; conflicting values are rejected. | |
| name_keyword | No | ||
| principal_id | No | ||
| principalType | No | Compatibility alias for principal_type; conflicting values are rejected. | |
| businessUnitId | No | Compatibility alias for business_unit_id; conflicting values are rejected. | |
| principal_type | No | Default systemuser. | |
| business_unit_id | No | ||
| environment_profile | No | Optional named environment profile for this call; omit to use the configured default. |