Skip to main content
FuseFuse
IntegrationsAwsActions

List IAM users

List IAM users with optional path prefix and opaque cursor pagination. Requires iam:ListUsers.

Agent markdown

iam.users.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:ListUsers

Input

Input schema
NameTypeRequiredConstraints
(root)objectYesadditionalProperties false
path_prefixstringNominLength 1; maxLength 512; pattern ^/$|^/[\x21-\x7e]+/$
page_sizeintegerNominimum 1; maximum 1000
cursorstringNominLength 1; maxLength 16384; pattern ^(?!.*://)[^\x00-\x1f\x7f]+$

Output

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

Raw schema

Input
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "path_prefix": {
      "type": "string",
      "minLength": 1,
      "maxLength": 512,
      "pattern": "^/$|^/[\\x21-\\x7e]+/$"
    },
    "page_size": {
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    },
    "cursor": {
      "type": "string",
      "minLength": 1,
      "maxLength": 16384,
      "pattern": "^(?!.*://)[^\\x00-\\x1f\\x7f]+$"
    }
  }
}
Output
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "users": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "name": {
            "type": "string",
            "minLength": 1,
            "maxLength": 64,
            "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
          },
          "password_last_used_at": {
            "type": "string",
            "minLength": 1,
            "maxLength": 64
          },
          "permissions_boundary_arn": {
            "type": "string",
            "minLength": 20,
            "maxLength": 2048,
            "pattern": "^arn:aws:.+$"
          },
          "tags": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": false,
              "properties": {
                "key": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 128
                },
                "value": {
                  "type": "string",
                  "maxLength": 256
                }
              },
              "required": [
                "key",
                "value"
              ]
            },
            "maxItems": 50
          }
        },
        "required": [
          "name",
          "id",
          "arn",
          "path",
          "created_at"
        ]
      },
      "maxItems": 1000
    },
    "next_cursor": {
      "type": "string",
      "minLength": 1,
      "maxLength": 16384,
      "pattern": "^(?!.*://)[^\\x00-\\x1f\\x7f]+$"
    }
  },
  "required": [
    "users"
  ]
}