Autenticación

El CLI se autentica con un token de acceso personal (PAT). Los tokens tienen el prefijo sapi_ y se crean desde la sesión web o desde el propio CLI si ya tenés un token existente.

Crear un token

Usá sureva auth token create para generar un nuevo PAT. Debés indicar una fecha de expiración en formato RFC 3339. El flag --name es opcional y toma el valor cli-token por defecto si se omite.

sureva auth token create --name mi-token --expires-at 2026-12-31T00:00:00Z

El valor del token se devuelve una sola vez en la respuesta JSON y no puede recuperarse después. Copialo de inmediato.

{
  "id": "tok_...",
  "name": "mi-token",
  "token": "sapi_abc123...",
  "expires_at": "2026-12-31T00:00:00Z"
}

auth login — no implementado

sureva auth login todavía no está implementado. El comando siempre devuelve un error not_implemented. La autenticación por device flow está planificada para una versión futura. Hasta entonces, creá tokens con auth token create (requiere un token existente) o desde la aplicación web de Sureva y exportalos como SUREVA_TOKEN.

Orden de resolución de credenciales

El CLI resuelve las credenciales en este orden (gana el primero que coincide):

Prioridad	Fuente
1	Variable de entorno SUREVA_TOKEN
2	Campo token en el archivo de configuración

Variable de entorno (recomendado para CI y agentes)

Configurá SUREVA_TOKEN en tu shell o entorno de CI:

export SUREVA_TOKEN=sapi_abc123...

En GitHub Actions u otros sistemas de CI, guardá el token como secreto e inyectalo como variable de entorno.

env:
  SUREVA_TOKEN: ${{ secrets.SUREVA_TOKEN }}

Archivo de configuración

El CLI lee la configuración desde:

Plataforma	Ruta
Linux / macOS	~/.config/sureva/config.yaml
Windows	%APPDATA%\sureva\config.yaml

Los permisos del archivo deben ser 0600 (solo lectura/escritura del propietario). El CLI rechaza archivos de configuración con permisos más amplios.

Ejemplo de archivo de configuración:

token: sapi_abc123...
org: mi-org
api_url: https://api.sureva.com

Resolución de la URL de API

Prioridad	Fuente
1	Variable de entorno SUREVA_API_URL
2	Campo api_url en el archivo de configuración
3	Valor por defecto: https://api.sureva.com

Resolución de la organización

Muchos comandos requieren --org. El CLI resuelve la organización en este orden:

Prioridad	Fuente
1	Flag --org <slug>
2	Variable de entorno SUREVA_ORG
3	Campo org en el archivo de configuración

Verificar la autenticación

sureva auth whoami

Gestionar tokens

Comando	Descripción
sureva auth token list	Lista todos tus PATs (el valor del token nunca se muestra)
sureva auth token revoke <id>	Revoca un token por su ID