APIs.io Engineering Platform AWS Identity and Access Management — #Action=ListUsers

naftiko: 1.0.0-alpha2
info:
  label: 'APIs.io Engineering Platform AWS Identity and Access Management — #Action=ListUsers'
  description: 'APIs.io Engineering Platform AWS Identity and Access Management — #Action=ListUsers. 2 operations. Lead operation:
    #Action=ListUsers. Self-contained Naftiko capability covering one Engineering Platform business surface.'
  tags:
  - Engineering Platform
  - '#Action=ListUsers'
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    ENGINEERING_PLATFORM_API_KEY: ENGINEERING_PLATFORM_API_KEY
capability:
  consumes:
  - type: http
    namespace: aws-iam-action-listusers
    baseUri: https://iam.amazonaws.com
    description: 'APIs.io Engineering Platform AWS Identity and Access Management — #Action=ListUsers business capability.
      Self-contained, no shared references.'
    resources:
    - name: '#Action=ListUsers'
      path: /#Action=ListUsers
      operations:
      - name: getlistusers
        method: GET
        description: <p>Lists the IAM users that have the specified path prefix. If no path prefix is specified, the operation
          returns all users in the Amazon Web Services account. If there are none, the operation returns an empty list.</p>
          <note> <p>IAM resour
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: PathPrefix
          in: query
          type: string
          description: '<p> The path prefix for filtering the results. For example: <code>/division_abc/subdivision_xyz/</code>,
            which would get all user names whose path starts with <'
        - name: Marker
          in: query
          type: string
          description: Use this parameter only when paginating results and only after you receive a response indicating that
            the results are truncated. Set it to the value of the <cod
        - name: MaxItems
          in: query
          type: integer
          description: <p>Use this only when paginating results to indicate the maximum number of items you want in the response.
            If additional items exist beyond the maximum you spec
        - name: Action
          in: query
          type: string
          required: true
        - name: Version
          in: query
          type: string
          required: true
      - name: postlistusers
        method: POST
        description: <p>Lists the IAM users that have the specified path prefix. If no path prefix is specified, the operation
          returns all users in the Amazon Web Services account. If there are none, the operation returns an empty list.</p>
          <note> <p>IAM resour
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: MaxItems
          in: query
          type: string
          description: Pagination limit
        - name: Marker
          in: query
          type: string
          description: Pagination token
        - name: Action
          in: query
          type: string
          required: true
        - name: Version
          in: query
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    authentication:
      type: apikey
      key: Authorization
      value: '{{env.ENGINEERING_PLATFORM_API_KEY}}'
      placement: header
  exposes:
  - type: rest
    namespace: aws-iam-action-listusers-rest
    port: 8080
    description: 'REST adapter for APIs.io Engineering Platform AWS Identity and Access Management — #Action=ListUsers. One
      Spectral-compliant resource per consumed operation, prefixed with /v1.'
    resources:
    - path: /v1/action-listusers
      name: action-listusers
      description: 'REST surface for #Action=ListUsers.'
      operations:
      - method: GET
        name: getlistusers
        description: <p>Lists the IAM users that have the specified path prefix. If no path prefix is specified, the operation
          returns all users in the Amazon Web Services account. If there are none, the operation returns an empty list.</p>
          <note> <p>IAM resour
        call: aws-iam-action-listusers.getlistusers
        with:
          PathPrefix: rest.PathPrefix
          Marker: rest.Marker
          MaxItems: rest.MaxItems
          Action: rest.Action
          Version: rest.Version
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: postlistusers
        description: <p>Lists the IAM users that have the specified path prefix. If no path prefix is specified, the operation
          returns all users in the Amazon Web Services account. If there are none, the operation returns an empty list.</p>
          <note> <p>IAM resour
        call: aws-iam-action-listusers.postlistusers
        with:
          MaxItems: rest.MaxItems
          Marker: rest.Marker
          Action: rest.Action
          Version: rest.Version
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: aws-iam-action-listusers-mcp
    port: 9090
    transport: http
    description: 'MCP adapter for APIs.io Engineering Platform AWS Identity and Access Management — #Action=ListUsers. One
      tool per consumed operation, routed inline through this capability''s consumes block.'
    tools:
    - name: p-lists-iam-users-that-have
      description: <p>Lists the IAM users that have the specified path prefix. If no path prefix is specified, the operation
        returns all users in the Amazon Web Services account. If there are none, the operation returns an empty list.</p>
        <note> <p>IAM resour
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: aws-iam-action-listusers.getlistusers
      with:
        PathPrefix: tools.PathPrefix
        Marker: tools.Marker
        MaxItems: tools.MaxItems
        Action: tools.Action
        Version: tools.Version
      outputParameters:
      - type: object
        mapping: $.
    - name: p-lists-iam-users-that-have-2
      description: <p>Lists the IAM users that have the specified path prefix. If no path prefix is specified, the operation
        returns all users in the Amazon Web Services account. If there are none, the operation returns an empty list.</p>
        <note> <p>IAM resour
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: aws-iam-action-listusers.postlistusers
      with:
        MaxItems: tools.MaxItems
        Marker: tools.Marker
        Action: tools.Action
        Version: tools.Version
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.