automation-cloud
latest
false
Automation Cloud API Guide
Last updated Sep 19, 2024

API Keys

You use API keys to establish a connection between the UiPath® platform and other applications that are external to it. External applications can be either UiPath desktop applications, or third-party applications.

API keys are available for several UiPath services (products).

Important: Support for API Key authentication will end March 2025. We recommend using External Applications or Personal Access Tokens (PATs) as the primary method of authentication.

Learn more about upcoming deprecations.

Orchestrator

About API Access

You can view API access information for each of your existing Orchestrator services on the Admin > Tenant > Services page.

This information is required for authenticating to your Orchestrator service in Automation Cloud via API calls.

Note: If you do not have access to the Admin page, which is only available to users who have the organization administrator role, you can get API access information from the Preferences page for your account.
Important:

Not applicable for Azure AD

If the authentication settings for your organization are set to use a directory integration, the API Access button is not available and these instructions are not applicable for you.

In this case, you must do one of the following:

  • log out of Automation Cloud and then log in with a UiPath® account instead of a directory account, or
  • (recommended) use the OAuth flow instead.

Viewing API Access Information

You can view the API access information for a service if you have the Organization Administrator role, or if you are assigned to that service.

  1. Navigate to Admin and select the tenant in the panel on the left.
  2. Click Services.

    The Services page opens, listing all existing services for the selected tenant.

  3. Click docs image on the Orchestrator card and select API Access:


    The API Access window is displayed with the following service-specific information:

    • User Key - allows you to generate unique login keys to be used by APIs or external applications to log in and perform actions on your behalf. This was previously known as your refresh token.
    • Account Logical Name - your organization name (for example myNewOrg).
    • Tenant Name - the tenant's display name.
    • Client ID - specific to the Orchestrator application itself, it is the same for all users and Orchestrator services on a specific platform. For example, all the Orchestrator services on cloud.uipath.com have the same Client ID value.
  4. Click the docs image icon next to each field to copy its value.


You can use the copied information to consume cloud APIs .

Revoking API Access

Revoking access cancels all previously assigned user keys, thus breaking all applications that rely on previously assigned user keys. A new user key is automatically generated for the selected Orchestrator service.

You must share the new user key to all the affected applications.

  1. Navigate to Admin and select the tenant in the panel on the left.
  2. Click Services.

    The Services page opens, listing all existing services for the selected tenant.

  3. Click docs image on the Orchestrator card and select API Access.

    The API Access window opens.

  4. Click Revoke Access.

    A confirmation window opens.

  5. Click Revoke to confirm your action.

    The value of the service's User Key is revoked and the Refresh Tokens Revoked window is displayed.

  6. Close the Refresh Tokens Revoked window.
  7. Copy and share the new key with users who need it.

Document Understanding

The API key for Document Understanding is available on the Admin > Licenses > Consumables > AI units page:



From here, you can:

  • Copy the key for use in external applications.
  • Click the refresh icon to generate a new key.
    Important: Generating a new key renders the old key invalid. Any external applications that used the old key cannot connect to Automation Cloud any more.

For more information, see API Key in the Document Understanding documentation.

Computer Vision

The API key for Computer Vision is available on the Admin > Organization > Licenses > Robots & Services page.



From here, you can:

  • Copy the key for use in external applications.
  • Click the Refresh icon to generate a new key.

    Important: Generating a new key renders the old key invalid. Any external applications that used the old key cannot connect to Automation Cloud anymore.

For more information, see Computer Vision .

  • Orchestrator
  • About API Access
  • Viewing API Access Information
  • Revoking API Access
  • Document Understanding
  • Computer Vision

Was this page helpful?

Get The Help You Need
Learning RPA - Automation Courses
UiPath Community Forum
Uipath Logo White
Trust and Security
© 2005-2024 UiPath. All rights reserved.