Producto
CLI

Ver sesión activa

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

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ámetroFlagRequeridoDescripción
Verificar--verifyNoHace 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--jsonNoImprime la sesión en JSON

Ejemplos

bash
01# Ver workspace, email y zona activos
02plazbot whoami
03 
04# Obtener la sesión en JSON
05plazbot whoami --json
06 
07# Comprobar que el token sigue funcionando (código 1 si no)
08plazbot whoami --verify
09 
10# Obtener solo el ID del workspace
11plazbot whoami --json | jq -r '.workspace'

Resultado

text
01 Active session
02 ────────────────────────────────────────
03 Email: tu@empresa.com
04 Workspace: Mi Empresa (wok_AbcDef123)
05 Zone: Americas (LA)
06 API: https://api.plazbot.com
07 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:

ValorOrigen
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": true
10}

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

MensajeCausaSolución
You are not signed in.No hay sesión guardada ni variables de entornoEjecuta 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 zonaRevisa 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
¿Quieres probar la API en vivo? Abre el Playground.