# Running unattended bots via UiPath Cloud Orchestrator

**Cloud vs. On-Premise:** These instructions are for the UiPath Cloud Orchestrator. For On-Premise Orchestrator support, contact <sales@pixiebrix.com>

### Configuring the UiPath Cloud Orchestrator Service

{% hint style="info" %}
**Private vs. Shared Credentials:** Currently, the UiPath Cloud Orchestrator Service can only be configured as a Private Service in the Browser Extension. Configuring UiPath as a Shared Service is coming soon
{% endhint %}

#### Locating Your UiPath API Credentials

The UiPath documentation has detailed instructions for [Viewing API Access Information](https://docs.uipath.com/automation-cloud/docs/about-api-access). As an administrator, open the Admin tab in UiPath Automation Cloud:

<figure><img src="https://2274778196-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fq123bF1HPQPV35s5vHa1%2Fuploads%2Fjg8p8jfyL1arKG7bJBIr%2FUntitled%20-%202023-11-01T140723.785.png?alt=media&#x26;token=b3e48b08-c026-4330-aac9-d31a4e09d702" alt=""><figcaption></figcaption></figure>

Click the Cloud Icon ☁️ in the Orchestrator row to view the API Information

#### Configuring the Service Credentials

1. Open the PixieBrix Extension (visit [app.pixiebrix.com](https://app.pixiebrix.com/) and click "Open Browser Extension")
2. Open the Configure Services page from the Sidebar
3. From the "Configure a new service dropdown", select UIPath Cloud Orchestrator<br>

   <figure><img src="https://2274778196-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fq123bF1HPQPV35s5vHa1%2Fuploads%2FZ4hCmOlx7ISsV5c77nk9%2Fimage.png?alt=media&#x26;token=f496cde2-00a9-4823-aec4-a2bea256c413" alt=""><figcaption></figcaption></figure>
4. Enter your UiPath Cloud Orchestrator API information

* accountName: the "Account Logical Name" field the API Information dialog. You can also locate the account name in the URL you use to access Cloud Orchestrator

  ```yaml
  <https://cloud.uipath.com/**>[Account Name]**/[Tenant Logical Name]/orchestrator_/
  ```
* tenantName: the "Tenant Name" field in the API Information dialog. You can also locate the tenant name in the URL you use to access Cloud Orchestrator. The default UiPath tenant name is `DefaultTenant`

  ```yaml
  <https://cloud.uipath.com/>[Account Name]/**[Tenant Logical Name]**/orchestrator_/
  ```
* clientId: The "Client Id" field in the API Information dialog
* userKey: The "User Key" field in the API Information dialog
* folderId: the folder id **number** (not name), that can be found as the `fid=` URL parameter when you select the folder in UiPath Cloud Orchestrator

<figure><img src="https://2274778196-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fq123bF1HPQPV35s5vHa1%2Fuploads%2FJCuZ2tiV74wIvOZ8b27u%2FUntitled%20-%202023-11-01T140803.408.png?alt=media&#x26;token=17bfea12-bea0-4988-ad58-a6f7ad594b83" alt=""><figcaption></figcaption></figure>

### Running the Process

Go to the Page Editor's and add the "Run a UiPath process" brick to your mod.<br>

<figure><img src="https://2274778196-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fq123bF1HPQPV35s5vHa1%2Fuploads%2F9md88fpkAjoux67YfEWX%2Fimage.png?alt=media&#x26;token=cf07cf31-2493-4965-8436-dd6ee5dee9f2" alt=""><figcaption></figcaption></figure>

Select the Process Release from the "release" dropdown. You should see all of the Release that are in the folder you configured above

<figure><img src="https://2274778196-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fq123bF1HPQPV35s5vHa1%2Fuploads%2FXMRhZpIIKs7f2zfncSlV%2Fimage.png?alt=media&#x26;token=34faadcb-cdb4-4bc1-9a2f-2bbe71198f6a" alt=""><figcaption></figcaption></figure>

Select a Strategy for running the Process:

* JobsCount (default): run the process *X* times across when the bots become available
* All: run the process on all unattended bots
* Specific: run the process on one or more bots that you select

Finally, configure the Input Arguments for your Process. PixieBrix automatically displays which Input Arguments are available. For example, the following screenshot shows configuring a "Crunchbase.Lookup" process that one argument, "OrganizationSlug":

<figure><img src="https://2274778196-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fq123bF1HPQPV35s5vHa1%2Fuploads%2FwTRuadY4xYHwUKqBkQ8t%2Fimage.png?alt=media&#x26;token=2a2cbae8-f084-4157-b62c-abf5939b7f9e" alt=""><figcaption></figcaption></figure>

#### Creating and Managing Process Arguments

You can learn how to create/manage input arguments for process in the UiPath documentation: [Managing Arguments](https://docs.uipath.com/studio/docs/managing-arguments)