Status de login do uip

Sintaxe e opções para "uip login status", que relata o estado de autenticação atual sem atualizar tokens.

relata o estado de autenticação uip login status : se você está conectado, quais organização e tenant estão selecionados e quando o token de acesso expira. É uma inspeção somente leitura da sessão armazenada — nenhum token é atualizado por esse comando.

Use-a em scripts para direcionar o trabalho de acompanhamento ou interativamente para confirmar a qual tenant uma chamada uip subsequente terá como alvo.

Resumo

uip login status

Esse comando honra as opções globais (--output, --output-filter, --log-level, --log-file). Os códigos de saída seguem o contrato padrão.

Argumentos

Nenhum.

Opções

Nenhum.

Observação:

login status não aceita -f, --file <folder> — ele sempre lê o local das credenciais padrão. Se você usar uma pasta de credenciais não padrão, execute novamente o comando uip login ... correspondente nessa pasta antes de verificar o status.

Exemplos

# Human-readable (default table output)
uip login status

# JSON for scripts
uip login status --output json

Formato dos dados (--output json)

{
  "Code": "LoginStatus",
  "Data": {
    "Status": "Logged in",
    "Identity": "[e-mail]",
    "IdentityType": "User",
    "AuthFlow": "Interactive",
    "CredentialSource": "SavedLogin",
    "Organization": "my-org",
    "OrganizationId": "00000000-0000-0000-0000-000000000001",
    "Tenant": "DefaultTenant",
    "TenantId": "00000000-0000-0000-0000-000000000002",
    "Expiration Date": "2026-04-18T10:30:00Z"
  }
}

• Status — one of Logged in or Not logged in. When not logged in, most fields below are omitted and Organization/Tenant fall back to N/A.
• Identity — who is acting: a user's email for interactive sessions, or "External application <clientId>" for a client-credentials/federated session. Omitted when it can't be determined.
• IdentityType — "User" or the External App's type. Present whenever Identity is.
• AuthFlow — how the identity was proven: "Interactive", "ClientCredentials", or "FederatedCredentials". Present when known.
• CredentialSource — where the session came from: "Robot", "EnvironmentVariables", "SavedLogin", or "N/A".
• UserId / UserEmail / UserName / ClientId — additional identity detail, each present only when the underlying session actually carries that field.
• Profile — the active named profile, when one is set and the session is file-based.
• Organization — nome da organização quando disponível; caso contrário, o ID da organização.
• OrganizationId — present alongside Organization when the ID is known separately from the name.
• Tenant — nome do tenant quando disponível; caso contrário, o ID do tenant. N/A se nenhum tenant for selecionado.
• TenantId — present alongside Tenant when the ID is known separately from the name.
• BaseUrl — the resolved identity/API base URL, when known.
• Expiration Date Carimbo de data/hora ISO-8601 da expiração do token de acesso. Isso não é atualizado aqui; uma invocação de ferramenta posterior atualizará o token, se necessário.
• Hint (optional) — advisory text when the auth layer has something to surface — for example, an opaque PAT session reports "Token is opaque (not a JWT) - expiration and identity cannot be determined locally. Commands will fail with 401 once it is revoked or expired." instead of an expiration date.
• Provider (deprecated) — a legacy, lower-fidelity version of CredentialSource ("Robot"/"Environment"/"File"/"N/A"), kept for one release for existing scripts. Read CredentialSource instead; Provider will be removed.

Exactly which fields appear depends on the auth flow — a PAT/environment-variable session, for example, has no Identity/AuthFlow (the token carries no claims to derive them from) but does carry CredentialSource and BaseUrl.

Comportamento de erro

Quando a sessão armazenada está ilegível ou o fallback da variável de ambiente (UIPATH_CLI_*) está incompleto, a CLI emite um ConfigError. O campo Instructions orienta você para a causa raiz correta:

• Se as variáveis de ambiente estiverem sendo usadas, mas estiverem configuradas incorretamente, as instruções lerão "Check the UIPATH_CLI_* environment variables and re-run."
• Caso contrário, as instruções apontarão para a pasta de credenciais no disco.

Relacionado

• uip login — autenticar e escolher um tenant.
• uip logout — limpar a sessão armazenada.
• Autenticação — o que Status reflete e como os tokens são atualizados.
• Sessões e credenciais — localização da pasta e regras de substituição.