# Ver sesión activa

> plazbot whoami: muestra la cuenta, el workspace y la zona con que trabaja el CLI

Fuente: https://developers.plazbot.com/cli/whoami/

### Ver la sesión activa

Muestra con qué cuenta, workspace y zona trabajan los comandos del CLI. Úsalo antes de un cambio importante para confirmar que estás en el workspace correcto. También funciona como `plazbot status`.

```bash
plazbot whoami [--verify] [--json]
```

### Parámetros

| Parámetro | Flag | Requerido | Descripción |
|-----------|------|-----------|-------------|
| Verificar | `--verify` | No | Hace una consulta real a la API para comprobar que el token sigue vigente y que el workspace existe en la zona. Termina con código `1` si falla |
| JSON | `--json` | No | Imprime la sesión en JSON |

### Ejemplos

```bash
# Ver workspace, email y zona activos
plazbot whoami

# Obtener la sesión en JSON
plazbot whoami --json

# Comprobar que el token sigue funcionando (código 1 si no)
plazbot whoami --verify

# Obtener solo el ID del workspace
plazbot whoami --json | jq -r '.workspace'
```

### Resultado

```text
Active session
────────────────────────────────────────
Email: tu@empresa.com
Workspace: Mi Empresa (wok_AbcDef123)
Zone: Americas (LA)
API: https://api.plazbot.com
Source: Browser login (plazbot login)
```

Con una sesión de [solo lectura](https://developers.plazbot.com/cli/login) se agrega `Access: read-only (cannot change data)`. Con `--verify` se agrega `Token: valid (workspace "Mi Empresa")`.

`Source` indica de dónde salen las credenciales:

| Valor | Origen |
|-------|--------|
| `Browser login (plazbot login)` | Sesión iniciada con [`plazbot login`](https://developers.plazbot.com/cli/login) |
| `API key (plazbot init)` | Key guardada con [`plazbot init`](https://developers.plazbot.com/cli/init) |
| `Environment variables (PLAZBOT_API_KEY)` | Variables `PLAZBOT_API_KEY` y `PLAZBOT_WORKSPACE_ID`. En este caso no se muestran email ni nombre del workspace |

### Salida JSON

```json
{
"email": "tu@empresa.com",
"workspace": "wok_AbcDef123",
"workspaceName": "Mi Empresa",
"zone": "LA",
"api": "https://api.plazbot.com",
"source": "login",
"readOnly": false,
"verified": true
}
```

`email` y `workspaceName` son `null` cuando no se conocen. `source` es `login`, `init` o `env`. `readOnly` es `true` en sesiones de solo lectura. `verified` solo aparece con `--verify`.

### Errores comunes

| Mensaje | Causa | Solución |
|---------|-------|----------|
| `You are not signed in.` | No hay sesión guardada ni variables de entorno | Ejecuta [`plazbot login`](https://developers.plazbot.com/cli/login) |
| `Your session is invalid or expired.` | Con `--verify`: el token fue revocado o venció | Ejecuta [`plazbot login`](https://developers.plazbot.com/cli/login) |
| `The token works but workspace wok_... was not found in zone LA.` | Con `--verify`: el workspace no existe en esa zona | Revisa la zona o cambia de workspace con [`plazbot workspace use`](https://developers.plazbot.com/cli/workspace) |

Sin sesión el comando termina con código `1`, así que sirve para comprobarla en un script:

```bash
plazbot whoami --verify > /dev/null 2>&1 || plazbot login
```
