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.

Resumo

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

Opções

Bandeira	Description
--path-name <name>	Required. App path name to check. Must contain at least one letter or digit.
--base-url <url>	URL base da UiPath (substituição de autenticação).
--org-id <id>	ID da organização (substituição de autenticação).
--org-name <name>	Nome da organização (substituição de autenticação).
--access-token <token>	Token de acesso (substituição de autenticação).

Exemplo

uip codedapp validate --path-name my-app

Formato dos dados (--output 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.

Modos de falha

ErrorCode	Causa
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.

Relacionado

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

Veja também

• Visão geral da ferramenta de Apps codificados
• Opções globais
• Códigos de saída