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
01plazbot 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
01# Ver workspace, email y zona activos02plazbot whoami0304# Obtener la sesión en JSON05plazbot whoami --json0607# Comprobar que el token sigue funcionando (código 1 si no)08plazbot whoami --verify0910# Obtener solo el ID del workspace11plazbot whoami --json | jq -r '.workspace'
Resultado
text
01 Active session02 ────────────────────────────────────────03 Email: tu@empresa.com04 Workspace: Mi Empresa (wok_AbcDef123)05 Zone: Americas (LA)06 API: https://api.plazbot.com07 Source: Browser login (plazbot login)
Con una sesión de solo lectura 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 |
API key (plazbot init) | Key guardada con plazbot 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
01{02 "email": "tu@empresa.com",03 "workspace": "wok_AbcDef123",04 "workspaceName": "Mi Empresa",05 "zone": "LA",06 "api": "https://api.plazbot.com",07 "source": "login",08 "readOnly": false,09 "verified": true10}
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 |
Your session is invalid or expired. | Con --verify: el token fue revocado o venció | Ejecuta plazbot 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 |
Sin sesión el comando termina con código 1, así que sirve para comprobarla en un script:
bash
01plazbot whoami --verify > /dev/null 2>&1 || plazbot login