# uip logout

> `uip logout` removes the credentials written by [`uip login`](./uip-login.md). The command clears the stored session; subsequent `uip` calls that need auth will fail with an authentication error until you log in again.

`uip logout` removes the credentials written by [`uip login`](./uip-login.md). 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>]
```

All `uip logout` subcommands honor the [global options](./global-options.md) (`--output`, `--output-filter`, `--log-level`, `--log-file`). Exit codes follow the [standard contract](./exit-codes.md).

## 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](./concepts-sessions.md)).

## Examples

```bash
# Remove the default session
uip logout

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

## Data shape (--output json)

```json
{
  "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.

## Related

- [`uip login`](./uip-login.md) — start a new session.
- [`uip login status`](./uip-login-status.md) — inspect the current session without modifying it.
- [Authentication](./authentication.md) — credential model and External Application flow.
- [Sessions and credentials](./concepts-sessions.md) — where `uip logout` clears from.