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á septiembre 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.

septiembre 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

septiembre 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 Septiembre y exportalos como SEPTIEMBRE_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 SEPTIEMBRE_TOKEN
2	Campo token en el archivo de configuración

Variable de entorno (recomendado para CI y agentes)

Configurá SEPTIEMBRE_TOKEN en tu shell o entorno de CI:

export SEPTIEMBRE_TOKEN=sapi_abc123...

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

env:
  SEPTIEMBRE_TOKEN: ${{ secrets.SEPTIEMBRE_TOKEN }}

Archivo de configuración

El CLI lee la configuración desde:

Plataforma	Ruta
Linux / macOS	~/.config/septiembre/config.yaml
Windows	%APPDATA%\septiembre\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.septiembre.ai

Resolución de la URL de API

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

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 SEPTIEMBRE_ORG
3	Campo org en el archivo de configuración

Verificar la autenticación

septiembre auth whoami

Gestionar tokens

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