list_iam_groups
List IAM groups at account or environment level to view group names, UUIDs, and types for access management.
Instructions
List visible groups at an organisational level (IAM v1). Requires iam:groups:read scope on an account-scoped platform token. level-type is 'account' or 'environment'; level-id is the corresponding UUID. Response array field: results (each item has uuid, groupName, type).
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": {
"levelType": "<levelType>",
"levelId": "<levelId>"
},
"name": "list_iam_groups"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| levelType | Yes | Organisational level type: 'account' or 'environment'. | |
| levelId | Yes | UUID of the level-type instance (e.g. account UUID). |