# 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 Files API
  version: 1.0.0
extends: openapi/automation-anywhere-files-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: 9
- target: $.paths['/file/list'].post
  update:
    x-apievangelist-phrasing:
      intent: Search bots and files across the repository
      effect: read
      questions:
      - Which bots and files are stored in the repository, and where are they?
      - Can I find repository files modified after a certain date?
      instructions:
      - text: Search the whole repository for files matching {filter}.
        slots:
          filter: requestBody.filter
      - text: List all bots and files in the repository.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/files/{fileid}/content'].get
  update:
    x-apievangelist-phrasing:
      intent: Download a repository file's contents
      effect: read
      questions:
      - Can I download the raw contents of a bot file from the repository?
      - What permission do I need to download a file from the Control Room repository?
      instructions:
      - text: Download the contents of file {fileid}.
        slots:
          fileid: path.fileid
      - text: Save a local copy of repository file {fileid}.
        slots:
          fileid: path.fileid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/files/{fileid}/dependencies'].get
  update:
    x-apievangelist-phrasing:
      intent: View the files a bot depends on
      effect: read
      questions:
      - What other bots and templates does this bot depend on before I export it?
      - Can I see a bot's full dependency tree before migrating it?
      instructions:
      - text: Show the dependencies of bot {fileid}.
        slots:
          fileid: path.fileid
      - text: List every file that bot {fileid} references.
        slots:
          fileid: path.fileid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/files/{fileid}/dependencies/{workspaceId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Set a bot's manual dependencies in a workspace
      effect: write
      questions:
      - Can I declare a bot's dependencies by hand when automatic detection misses some?
      - Are manual dependencies set per workspace, public or private?
      instructions:
      - text: Set the manual dependencies of bot {fileid} in the {workspaceId} workspace to {dependencies}.
        slots:
          fileid: path.fileid
          workspaceId: path.workspaceId
          dependencies: requestBody.dependencies
      - text: Declare dependencies explicitly for bot {fileid} in workspace {workspaceId}.
        slots:
          fileid: path.fileid
          workspaceId: path.workspaceId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/files/{fileid}/parents'].get
  update:
    x-apievangelist-phrasing:
      intent: Find the parent folder of a file
      effect: read
      questions:
      - Which folder is a given bot file stored in?
      - Can I get the folder path and ID that contains a repository file?
      instructions:
      - text: Find the parent folder of file {fileid}.
        slots:
          fileid: path.fileid
      - text: Show the folder path containing file {fileid}.
        slots:
          fileid: path.fileid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/files/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a file from the repository
      effect: destructive
      questions:
      - Can a deleted repository file be recovered through the API?
      - Why would deleting a bot file fail while automations are running?
      instructions:
      - text: Delete repository file {id}.
        slots:
          id: path.id
      - text: Permanently remove bot file {id} from the repository.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/files/packagesVersionUpdate'].post
  update:
    x-apievangelist-phrasing:
      intent: Bulk-update package versions used by bots
      effect: write
      questions:
      - After a platform upgrade, can I update all my bots to the latest package versions at once?
      - Can I move just one package to a specific version across several bots?
      instructions:
      - text: Update package {packageName} to version {targetVersion} in bots {fileIds}.
        slots:
          packageName: requestBody.packageName
          targetVersion: requestBody.targetVersion
          fileIds: requestBody.fileIds
      - text: Upgrade all packages to the latest version in bot files {fileIds}.
        slots:
          fileIds: requestBody.fileIds
      method: generated
      generated: '2026-09-26'
- target: $.paths['/files/version/assignLabel'].post
  update:
    x-apievangelist-phrasing:
      intent: Mark a bot version as production
      effect: write
      questions:
      - Can I mark one version of a bot as the production-ready version?
      - Which bot version gets deployed in production, and how is that set?
      instructions:
      - text: Assign the production label to version {version} of bot {fileId}.
        slots:
          version: requestBody.version
          fileId: requestBody.fileId
      - text: Promote bot {fileId} version {version} to production.
        slots:
          fileId: requestBody.fileId
          version: requestBody.version
      method: generated
      generated: '2026-09-26'
- target: $.paths['/recover'].post
  update:
    x-apievangelist-phrasing:
      intent: Recover bots from a deleted user's workspace
      effect: write
      questions:
      - Can I rescue the private bots of a user who was removed from the Control Room?
      - Where do recovered bots from a deleted user end up?
      instructions:
      - text: Recover the bots of deleted user {userId} into public folder {targetFolderId}.
        slots:
          userId: requestBody.userId
          targetFolderId: requestBody.targetFolderId
      - text: Move deleted user {userId}'s private bots to the public workspace.
        slots:
          userId: requestBody.userId
      method: generated
      generated: '2026-09-26'