UiPath Documentation
apps
latest
false
  • Apps API
    • Base URL
    • Get deployed apps
    • Edit a deployed app
    • Deploy a published app version
    • Upgrade deployed apps to latest version
    • Publish a coded app
    • Check app name uniqueness
    • Get published apps
    • Get published app versions
important :
For documentation on app projects in Studio Web, refer to the App Projects chapter in the Studio Web documentation: https://docs.uipath.com/studio-web/automation-cloud/latest/user-guide/apps-in-studio-web.

Apps API guide

Get deployed apps

Retrieves all deployed apps in a folder.

API endpoint

GET <BaseURL>/models/deployed/apps

See Base URL for the root endpoint path.

Request headers

HeaderValue
AuthorizationBearer <access_token>
X-UiPath-Internal-TenantId<tenant_id>
X-UiPath-FolderKey<folder_key>
Note:

Replace all the values between the angle brackets <...> with their corresponding use-case values.

The <access_token> is the one you received when you authorized the external application with the Apps or Apps.Read scope. It is available for 1 hour, then you need to generate a new one, or request a refresh token.

Query parameters

Query parameterData typeDescriptionDefault value
top (optional)int32The number of results to return.N/A
skip (optional)int32The number of results to skip.N/A
orderBy (optional)stringThe field to order results by.N/A
searchText (optional)stringFilters results by the specified search text.N/A
tags (optional)stringComma-separated list of system tag values to filter by.N/A

Responses

200 OK

{
  "@odata.context": "string",
  "@odata.count": 1,
  "value": [
    {
      "id": "string",
      "appSystemName": "string",
      "title": "string",
      "description": "string",
      "version": 1,
      "routingName": "string",
      "tags": ["string"]
    }
  ]
}
{
  "@odata.context": "string",
  "@odata.count": 1,
  "value": [
    {
      "id": "string",
      "appSystemName": "string",
      "title": "string",
      "description": "string",
      "version": 1,
      "routingName": "string",
      "tags": ["string"]
    }
  ]
}
FieldData typeDescription
@odata.contextstringThe OData context URL.
@odata.countnumberThe total number of deployed apps matching the query.
valuearrayThe list of deployed apps.
value[].idstringThe deployment ID of the app.
value[].appSystemNamestringThe system name of the app.
value[].titlestringThe display title of the deployed app.
value[].descriptionstringThe description of the deployed app.
value[].versionnumberThe deployed version number.
value[].routingNamestringThe routing name used in the app URL.
value[].tagsstring[]The system tag values attached to the deployed app.

401 Unauthorized

You are not authenticated. Make sure you are using a valid access token with the Apps or Apps.Read scope.

403 Forbidden

You don't have permission to view deployed apps in the specified folder.

  • API endpoint
  • Request headers
  • Query parameters
  • Responses
  • 200 OK
  • 401 Unauthorized
  • 403 Forbidden

Was this page helpful?

Connect

Need help? Support

Want to learn? UiPath Academy

Have questions? UiPath Forum

Stay updated