Automation Anywhere · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for Automation Anywhere Repository Management Permissions API

3 actions 3 updates phrasing extends openapi/automation-anywhere-permissions-api-openapi.yml

Generated by API Evangelist Written by API Evangelist tooling for Automation Anywhere's API. It is a proposal applied on top of the contract, not a document Automation Anywhere publishes.

View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-phrasing

Targets 3

$.info

$.paths['/role/{roleid}/folder/{folderid}/permissions'].get

$.paths['/role/{roleid}/permissions'].put

OpenAPI Overlay

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Automation Anywhere Repository Management Permissions API
  version: 1.0.0
extends: openapi/automation-anywhere-permissions-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 2
- target: $.paths['/role/{roleid}/folder/{folderid}/permissions'].get
  update:
    x-apievangelist-phrasing:
      intent: View a role's permissions on a folder
      effect: read
      questions:
      - 'What can a given role do in a specific repository folder: view, run, upload, delete?'
      - Can I check whether a role is allowed to run bots in a particular folder?
      instructions:
      - text: Show role {roleid}'s permissions on folder {folderid}.
        slots:
          roleid: path.roleid
          folderid: path.folderid
      - text: Check what actions role {roleid} can perform in folder {folderid}.
        slots:
          roleid: path.roleid
          folderid: path.folderid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/role/{roleid}/permissions'].put
  update:
    x-apievangelist-phrasing:
      intent: Grant a role permissions on repository folders
      effect: write
      questions:
      - Can I give a role access to specific folders with fine-grained actions?
      - How are folder permissions for a role specified when granting them?
      instructions:
      - text: 'Grant role {roleid} these folder permissions: {folderPermissions}.'
        slots:
          roleid: path.roleid
          folderPermissions: requestBody.folderPermissions
      - text: Update the repository folder permissions for role {roleid}.
        slots:
          roleid: path.roleid
      method: generated
      generated: '2026-09-26'