Skip to main content
FuseFuse
IntegrationsAwsActions

List IAM groups for user

List IAM groups for a user with opaque cursor pagination. Requires iam:ListGroupsForUser.

Agent markdown

iam.users.groups.list · AWS · v1

Details

Risk
Read
Idempotency
Safe
Availability
Default
Exposure
REST, SDK, MCP
MCP hints
readOnly=true, destructive=false, idempotent=true, openWorld=true

Scopes

  • iam:ListGroupsForUser

Input

Input schema
NameTypeRequiredConstraints
(root)objectYesadditionalProperties false
user_namestringYesminLength 1; maxLength 64; pattern ^[A-Za-z0-9_+=,.@-]+$
page_sizeintegerNominimum 1; maximum 1000
cursorstringNominLength 1; maxLength 16384; pattern ^(?!.*://)[^\x00-\x1f\x7f]+$

Output

Output schema
NameTypeRequiredConstraints
(root)objectYesadditionalProperties false
groupsarray<object>YesmaxItems 1000
groups[]objectYesadditionalProperties false
groups[].namestringYesminLength 1; maxLength 128; pattern ^[A-Za-z0-9_+=,.@-]+$
groups[].idstringYesminLength 1; maxLength 128
groups[].arnstringYesminLength 20; maxLength 2048; pattern ^arn:aws:.+$
groups[].pathstringYesminLength 1; maxLength 512; pattern ^/$|^/[\x21-\x7e]+/$
groups[].created_atstringYesminLength 1; maxLength 64
next_cursorstringNominLength 1; maxLength 16384; pattern ^(?!.*://)[^\x00-\x1f\x7f]+$

Raw schema

Input
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "user_name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "pattern": "^[A-Za-z0-9_+=,.@-]+$"
    },
    "page_size": {
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    },
    "cursor": {
      "type": "string",
      "minLength": 1,
      "maxLength": 16384,
      "pattern": "^(?!.*://)[^\\x00-\\x1f\\x7f]+$"
    }
  },
  "required": [
    "user_name"
  ]
}
Output
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "groups": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "name": {
            "type": "string",
            "minLength": 1,
            "maxLength": 128,
            "pattern": "^[A-Za-z0-9_+=,.@-]+$"
          },
          "id": {
            "type": "string",
            "minLength": 1,
            "maxLength": 128
          },
          "arn": {
            "type": "string",
            "minLength": 20,
            "maxLength": 2048,
            "pattern": "^arn:aws:.+$"
          },
          "path": {
            "type": "string",
            "minLength": 1,
            "maxLength": 512,
            "pattern": "^/$|^/[\\x21-\\x7e]+/$"
          },
          "created_at": {
            "type": "string",
            "minLength": 1,
            "maxLength": 64
          }
        },
        "required": [
          "name",
          "id",
          "arn",
          "path",
          "created_at"
        ]
      },
      "maxItems": 1000
    },
    "next_cursor": {
      "type": "string",
      "minLength": 1,
      "maxLength": 16384,
      "pattern": "^(?!.*://)[^\\x00-\\x1f\\x7f]+$"
    }
  },
  "required": [
    "groups"
  ]
}