Endpoints / Autenticación
Renovar sesión
Renueva la sesión usando un refreshToken válido y devuelve un nuevo par de tokens.
/auth/refreshCaso de Uso
Usa este endpoint cuando el accessToken expiró y el sistema necesita mantener la sesión activa sin pedir nuevamente las credenciales del usuario.
Autenticación
No requiere token JWT.
Parámetros de ruta
Este endpoint no recibe parámetros de ruta.
Body
refreshTokenstringobligatorioToken de refresco vigente que se usa para solicitar un nuevo accessToken y un nuevo refreshToken.
Reglas de negocio
El cliente debe enviar un refreshToken vigente.
El backend valida el token usando su hash guardado en la base de datos.
El token no debe estar revocado ni expirado.
El usuario y la empresa asociados deben estar activos.
Si la renovación es correcta, el refresh token anterior se revoca y se emite uno nuevo.
El nuevo refresh token registra ip y user-agent cuando están disponibles.
Errores esperados
Ocurre cuando el refreshToken no existe, ya fue revocado o ya expiró.
Ocurre cuando el usuario asociado al token ya no está activo.
Ocurre cuando la empresa asociada al usuario ya no está activa.
Ocurre cuando no se envía refreshToken o se envía vacío.
Ocurre si falla una operación interna al consultar, revocar o crear tokens.
Notas de uso
No envíes el header Authorization; este endpoint trabaja únicamente con refreshToken.
Reemplaza siempre el refreshToken anterior por el nuevo valor recibido.
Si recibes 401 Unauthorized, el usuario debe iniciar sesión nuevamente.
Usa la misma variable de entorno que el resto de la documentación para la base URL.