Automation API

To deploy bots onto the Automation Environment, currently the user has to login to Control Room, select the bot and the Bot Runners and then 'Run/Schedule' the task.

However, as the Automation scenarios scale up, there is an increasing need to deploy/trigger bots from an external third party application.

To meet this business requirement, Automation Anywhere has published Application Programming Interfaces (APIs) using which a bot can be triggered from an external system.

A Control Room user can use these APIs to deploy bots (Tasks) to Bot Runners on commencement of events specified by a third-party/external application.

Key Features and Business Benefits of Control Room APIs

• bots can be deployed from an external third party systems using Automation Anywhere APIs.
• The input and output of APIs is JSON based (industry standard data-interchange format).
• bot Deployment can be orchestrated from an External Application / Workflow using a combination of scripts and Automation Anywhere APIs.

Also, the user will need to have the 'Run my bots' privileges and the privileges of the Bot Runners on which the bot is to be deployed.

Deployment endpoint

The Deployment endpoint is used to deploy bots to Bot Runners.

API: <Control Room URL>/v1/schedule/automations/deploy

The user can pass three parameters as JSON string.

1. bot name with relative path – This is mandatory.
2. List of Bot Runners and users in JSON format – This is mandatory.
3. Use RDP based approach – This is optional and set to false by default.

Deployment Scenario and corresponding JSON string:

1. For example, the name of the bot is Accountsbot.atmx and the bot is under 'My Tasks'
2. The bot is to be deployed on 2 machines
   • First machine hostname BR-1 with user U-1
   • Second machine hostname BR-2 with user U-2
3. The JSON string in the above scenario will be:

   {
     "taskRelativePath": "My Tasks\\AccountsBot.atmx",
     "botRunners":
    [
       {
         "client": "BR-1",
         "user": "U-1"
       },
       {
         "client": "BR-2",
         "user": "U-2"
       }
     ]
   }

Response Codes