UiPath Documentation
uipath-cli
latest
false
UiPath CLI user guide

uip logout

Syntax and options for `uip logout`, which removes the stored credentials written by `uip login`.

uip logout removes the credentials written by uip login. The command clears the stored session; subsequent uip calls that need auth will fail with an authentication error until you log in again.

Synopsis​

uip logout [-f <folder>]
uip logout [-f <folder>]

All uip logout subcommands honor the global options (--output, --output-filter, --log-level, --log-file). Exit codes follow the standard contract.

Arguments​

None.

Options​

  • -f, --file <folder> — Path to the credentials folder to clear. If omitted, the default credentials folder is cleared (see Sessions and credentials). Mutually exclusive with the global --profile flag — passing both fails with ValidationError: option '--profile' cannot be used with option '--file'.

Examples​

# Remove the default session
uip logout

# Remove credentials from a project-scoped folder
uip logout -f ./.uipath
# Remove the default session
uip logout

# Remove credentials from a project-scoped folder
uip logout -f ./.uipath

Data shape (--output json)​

{
  "Code": "Message",
  "Data": {
    "Message": "Logged out successfully. Removed /path/to/.uipath"
  }
}
{
  "Code": "Message",
  "Data": {
    "Message": "Logged out successfully. Removed /path/to/.uipath"
  }
}

On failure — typically a filesystem permissions issue — the command emits a Failure result with Instructions: "Failed to logout. Check file permissions and try again.".

Idempotency and CI usage​

Logging out when no session exists is not an error condition you need to guard against in scripts; the CLI emits a structured success message referencing the folder it cleaned up (or the fact that nothing was there). This is safe to use as a teardown step in CI.

Was this page helpful?

Connect

Need help? Support

Want to learn? UiPath Academy

Have questions? UiPath Forum

Stay updated