uip codedapp validate

Syntax and options for `uip codedapp validate`, which checks whether a coded app path name is free and which app holds it.

uip codedapp validate checks whether a coded app path name (https://<org>.uipath.host/<path-name>) is free in the organization, and names the app that holds it when it is taken. Run it before uip codedapp deploy --path-name to avoid a path-name conflict.

The path name is converted the same way deploy converts --path-name (refer to Package ID), so both commands act on the same name. A value that is empty after conversion, or longer than 64 characters, is rejected before any request is sent.

The check is organization-scoped, so the command takes no tenant or folder options.

大纲

uip codedapp validate --path-name <name> [options]

选项

标记	描述
--path-name <name>	Required. App path name to check. Must contain at least one letter or digit.
--base-url <url>	UiPath 基本 URL（身份验证覆盖）。
--org-id <id>	组织 ID（身份验证覆盖）。
--org-name <name>	组织名称（身份验证覆盖）。
--access-token <token>	访问令牌（身份验证覆盖）。

示例

uip codedapp validate --path-name my-app

数据形状（--输出 json）

A free path name:

{
  "Code": "CodedAppPathNameChecked",
  "Data": {
    "PathName": "my-app",
    "Available": true,
    "OccupiedBy": null
  }
}

A taken path name also describes the app that holds it:

{
  "Code": "CodedAppPathNameChecked",
  "Data": {
    "PathName": "my-app",
    "Available": false,
    "OccupiedBy": {
      "Id": "6f1c2b4a-0000-0000-0000-000000000001",
      "DeploymentTitle": "My App",
      "Title": "My App package title",
      "SystemName": "my-app_abc123",
      "SemVersion": "1.2.0",
      "DeployVersion": 3,
      "DeploymentDescription": "Expense approvals",
      "IsLatestVersion": true,
      "IsAppPublic": false,
      "DateDeployed": "2026-09-18T10:12:04.000Z",
      "DeploymentFolder": {
        "Key": "3f8b1d22-0000-0000-0000-000000000001",
        "DisplayName": "Shared"
      },
      "IsResourceActivated": true,
      "RoutingName": "my-app"
    }
  }
}

Both outcomes are a success and exit 0, so scripts read Data.Available rather than the exit code. When a path name is taken but the holding app cannot be determined, OccupiedBy is null and the CLI prints a warning on stderr.

故障模式

ErrorCode	原因
permission_denied	The account lacks Apps or Apps.Read on the organization. For an external application token without an Apps scope, the message names the Apps.Read scope to grant and add to uip login --scope.
authentication_required	The session is invalid or expired. Run uip login.
server_error	The service could not answer. The name is neither confirmed free nor confirmed taken; retry later.

相关内容

• uip codedapp deploy: deploy an app under the path name you checked.

另请参阅

• 编码 Apps 工具概述
• 全局选项
• 退出代码