uip é conexões

Sintaxe e opções para "uip is Connections", que gerencia sessões do OAuth entre um tenant da UiPath e conectores externos.

uip is connections manages the tenant's OAuth sessions against connectors. A connection is the authenticated link between a UiPath tenant folder and an external account; it carries the tokens that resources run and activities use at runtime. The verbs cover discovery (list, export), authentication (create, edit), health checks (ping), and management (rename, set-default, update-polling-interval, base-url, delete). create and edit open the connector's OAuth URL in a browser and poll the server for completion (5-second interval, 5-minute total timeout).

Resumo

uip is connections <verb> [options]

Verbo

Texto	Finalidade
list	List connections, optionally scoped to a connector, folder, or BYOA status.
export	Export every connection (across all folders) for audit.
create	Crie uma nova conexão por meio do fluxo OAuth do conector.
ping	Verifique se uma conexão está habilitada e acessível no momento.
edit	Autentique novamente uma conexão existente por meio do fluxo do OAuth.
rename	Rename an existing connection.
set-default	Mark a connection as the default for its connector.
update-polling-interval	Change a connection's polling interval.
base-url	Get the API base URL a connection resolves to.
delete	Delete a connection (destructive, requires -y/--yes).

uip é lista de conexões

List connections in the tenant's default scope. Optional positional <connector-key> filters the result to one connector; flags can scope by folder, connection ID, or BYOA status.

Argumentos

Name	Required	Finalidade
[connector-key]	não	Chave de conector pela qual filtrar (por exemplo, uipath-zoho-desk). Omita para listar todos os conectores.

Opções

Short	Long	Valor	Padrão	Description
—	--folder-key	UUID	—	Search connections in a specific folder. Must be a UUID. Mutually exclusive with --all-folders.
—	--connection-id	id	—	Filtre para um ID de conexão específico.
—	--byoa	Bandeira	desativada	Filter to BYOA (Bring Your Own Account) connections only.
—	--all-folders	Bandeira	desativada	Search connections across all folders instead of the default scope. Mutually exclusive with --folder-key — combining them fails with a Failure before any request is made.
—	--refresh	Bandeira	desativada	Força a nova busca da API, ignorando o cache.

Exemplos

uip is connections list

uip is connections list uipath-zoho-desk

uip is connections list --byoa --all-folders

uip is connections list uipath-zoho-desk --refresh \
    --output-filter 'Data[].{id:Id, state:State}'

Formato dos dados (--output json)

{
  "Code": "ConnectionList",
  "Data": [
    {
      "Id": "a1b2c3d4-0000-0000-0000-000000000001",
      "Name": "Zoho Desk - Prod",
      "ConnectorKey": "uipath-zoho-desk",
      "ConnectorName": "Zoho Desk",
      "State": "Enabled",
      "Owner": "[e-mail]",
      "IsDefault": "No",
      "ByoaConnection": "No",
      "ElementInstanceId": 123456,
      "Folder": "Shared",
      "FolderKey": "f0f0f0f0-0000-0000-0000-000000000001",
      "Created": "2026-01-10T10:00:00.000Z",
      "Updated": "2026-01-10T10:00:00.000Z"
    }
  ]
}

Se algumas conexões estiverem desabilitadas, a resposta carregará um campo Warning ao lado de Data. Um --folder-key inválido que não é um UUID é rejeitado antecipadamente.

uip is connections export

Export every connection across all folders, for audit purposes. Takes no arguments or connection-scoping options — it always covers the full tenant.

Argumentos

Nenhum.

Exemplo

uip is connections export

Formato dos dados (--output json)

{
  "Code": "ConnectionExport",
  "Data": {
    "a1b2c3d4-0000-0000-0000-000000000001": {
      "id": "a1b2c3d4-0000-0000-0000-000000000001",
      "name": "Zoho Desk - Prod",
      "state": "Enabled"
    }
  }
}

Data is a map keyed by connection ID — not an array. When the tenant has no connections at all, the response is instead {"Code": "Message", "Data": {"Message": "No connections found to export."}}.

uip são conexões criadas

Crie uma nova conexão por meio do fluxo OAuth do conector. A CLI abre o URL de autenticação no seu navegador (a menos que você passe --no-browser) e pesquisa o servidor para conclusão. Intervalo de pesquisa: 5 segundos. Tempo limite total: 5 minutos.

Argumentos

Name	Required	Finalidade
<connector-key>	sim	Chave de conector, por exemplo uipath-zoho-desk

Opções

Short	Long	Valor	Padrão	Description
—	--no-browser	Bandeira	desativada	Não abra o navegador automaticamente; imprimir o URL para navegação manual.
—	--no-wait	Bandeira	desativada	Return the pending authorization details (SessionId, AuthUrl) immediately instead of polling for completion.

Exemplos

uip is connections create uipath-zoho-desk

# Headless / CI-friendly — print the URL instead of launching a browser
uip is connections create uipath-zoho-desk --no-browser

# Return immediately with the pending session instead of polling
uip is connections create uipath-zoho-desk --no-browser --no-wait

Formato dos dados (--output json)

{
  "Code": "ConnectionCreated",
  "Data": {
    "ConnectionId": "a1b2c3d4-0000-0000-0000-000000000010",
    "ConnectionName": "Zoho Desk",
    "Connector": "Zoho Desk",
    "State": "Enabled",
    "Owner": "[e-mail]",
    "Folder": "Shared",
    "FolderKey": "f0f0f0f0-0000-0000-0000-000000000001"
  }
}

With --no-wait, the response is instead the pending authorization:

{
  "Code": "ConnectionAuthorizationPending",
  "Data": {
    "Status": "AuthorizationPending",
    "SessionId": "s1000000-0000-0000-0000-000000000001",
    "AuthUrl": "https://.../authorize?...",
    "Instructions": "Open AuthUrl to authorize the connection, then run 'uip is connections list' or 'uip is connections ping <connection-id>' to verify the connection.",
    "Connector": "uipath-zoho-desk"
  }
}

Modos de falha:

• O usuário recusa ou a autenticação falha: Failure com a mensagem do servidor; saída 1.
• Tempo limite de enquete (5 minutos): Failure: "Authentication timed out after 5 minutes"; saída 2.
• Falha no transporte de pesquisa: Failure; saída 1.
• Interrompido/anulado (Ctrl+C): Failure; saída 1.

uip é conexões ping

Verifique se uma conexão está habilitada e acessível no momento.

Argumentos

Name	Required	Finalidade
<connection-id>	sim	ID de conexão (UUID) retornado por connections list ou connections create.

Opções

Short	Long	Valor	Padrão	Description
—	--force-refresh	Bandeira	desativada	Force a live connection status refresh instead of using a cached status.

Exemplos

uip is connections ping a1b2c3d4-0000-0000-0000-000000000001

uip is connections ping a1b2c3d4-0000-0000-0000-000000000001 --force-refresh

Formato dos dados (--output json)

{
  "Code": "ConnectionPing",
  "Data": {
    "ConnectionId": "a1b2c3d4-0000-0000-0000-000000000001",
    "Status": "Enabled",
    "Message": "Connection is active."
  }
}

Uma conexão desabilitada ou inacessível emite Failure com Instructions: "Run 'uip is connections edit <id>' to re-authenticate.".

uip é edição de conexões

Autentique novamente uma conexão existente. Mesmo fluxo de OAuth que create, direcionado a um ID de conexão existente em vez de emitir um novo. Mesmo contrato de pesquisa e códigos de saída.

Argumentos

Name	Required	Finalidade
<connection-id>	sim	ID de conexão para autenticar novamente.

Opções

Short	Long	Valor	Padrão	Description
—	--no-browser	Bandeira	desativada	Não abra o navegador automaticamente; imprimir o URL para navegação manual.
—	--no-wait	Bandeira	desativada	Return the pending authorization details immediately instead of polling for completion.

Exemplos

uip is connections edit a1b2c3d4-0000-0000-0000-000000000001

uip is connections edit a1b2c3d4-0000-0000-0000-000000000001 --no-browser

Formato dos dados (--output json)

{
  "Code": "ConnectionEdited",
  "Data": {
    "ConnectionId": "a1b2c3d4-0000-0000-0000-000000000001",
    "State": "Enabled"
  }
}

With --no-wait, the response is the same pending-authorization shape shown under create above.

uip is connections rename

Rename an existing connection.

Argumentos

Name	Required	Finalidade
<connection-id>	sim	Connection ID to rename.

Opções

Short	Long	Valor	Padrão	Description
—	--name	text	—	Required. New connection name. Cannot be empty.

Exemplo

uip is connections rename a1b2c3d4-0000-0000-0000-000000000001 \
    --name "Zoho Desk - Production"

Formato dos dados (--output json)

{
  "Code": "ConnectionRenamed",
  "Data": {
    "ConnectionId": "a1b2c3d4-0000-0000-0000-000000000001",
    "Name": "Zoho Desk - Production"
  }
}

A conflicting or invalid new name fails with Failure, pointing at connections list to verify the ID and pick a non-conflicting name.

uip is connections set-default

Mark a connection as the default connection for its connector — the one picked automatically where a connector allows only one active default.

Argumentos

Name	Required	Finalidade
<connection-id>	sim	Connection ID to set as default.

Exemplo

uip is connections set-default a1b2c3d4-0000-0000-0000-000000000001

Formato dos dados (--output json)

{
  "Code": "ConnectionSetDefault",
  "Data": {
    "ConnectionId": "a1b2c3d4-0000-0000-0000-000000000001",
    "Message": "Connection set as default."
  }
}

uip is connections update-polling-interval

Change how often the connection polls for events (used by event-driven activities/triggers built on this connection).

Argumentos

Name	Required	Finalidade
<connection-id>	sim	Connection ID to update.

Opções

Short	Long	Valor	Padrão	Description
—	--polling-interval	minutos	—	Required. New polling interval, in minutes. Must be a positive integer.

Exemplo

uip is connections update-polling-interval a1b2c3d4-0000-0000-0000-000000000001 \
    --polling-interval 15

Formato dos dados (--output json)

{
  "Code": "ConnectionPollingIntervalUpdated",
  "Data": {
    "ConnectionId": "a1b2c3d4-0000-0000-0000-000000000001",
    "PollingIntervalInMinutes": 15
  }
}

A non-integer or non-positive value fails client-side before any request is sent. If the connection doesn't support a configurable polling interval, the server rejects the request — verify the connection ID with connections list --refresh and confirm the connector supports polling.

uip is connections base-url

Get the API base URL a connection currently resolves to — useful when building a raw HTTP request against the connector's underlying API.

Argumentos

Name	Required	Finalidade
<connection-id>	sim	Connection ID to inspect.

Exemplo

uip is connections base-url a1b2c3d4-0000-0000-0000-000000000001

Formato dos dados (--output json)

{
  "Code": "ConnectionBaseUrl",
  "Data": {
    "ConnectionId": "a1b2c3d4-0000-0000-0000-000000000001",
    "BaseUrl": "https://api.example.com/v2"
  }
}

Failure points at connections list to verify the ID and confirm the connection is Enabled.

uip is connections delete

Delete a connection. This is irreversible — the CLI never prompts.

Argumentos

Name	Required	Finalidade
<connection-id>	sim	Connection ID to delete.

Opções

Short	Long	Valor	Padrão	Description
-y	--yes	Bandeira	—	Required. Confirms this irreversible operation.

Exemplo

uip is connections delete a1b2c3d4-0000-0000-0000-000000000001 --yes

Formato dos dados (--output json)

{
  "Code": "ConnectionDeleted",
  "Data": {
    "ConnectionId": "a1b2c3d4-0000-0000-0000-000000000001",
    "Message": "Connection deleted successfully."
  }
}

An unknown connection ID fails with Failure pointing at connections list --all-folders to find it.

Relacionado

• uip is connectors — descubra as chaves do conector para create.
• uip is resources — resources run requires --connection-id from a connection here.
• uip is activities — liste as operações que a conexão pode gerar.
• uip is triggers — ganchos de evento ativados por meio de uma conexão.

Veja também

• Visão geral da ferramenta do Integration Service
• Opções globais
• Códigos de saída