Rivian connection renewal
Use this runbook when the sidebar recommends renewal, a vehicle reports
reauth_required, or telemetry does not recover after Refresh Rivian login.
Interpret the status
renewal_soonbegins seven days before the estimated 180-day renewal date.renewal_duemeans the estimate has passed; it is not proof that Rivian has rejected the token.reauth_requiredis based on an observed authentication failure and overrides the estimate.- Normal CSRF/application-session rotation and WebSocket TTL reconnects do not reset the estimate and do not require user action.
Rivian does not publish a supported token-lifetime contract. Treat the timer as preventive maintenance and use runtime authentication evidence as authoritative.
Renew and verify
- Open Settings → Vehicles and choose Refresh Rivian login for the affected vehicle.
- Complete Rivian MFA if requested. Do not copy passwords, OTP values, or tokens into logs or support records.
- Wait for the completion state.
connectedmeans the worker authenticated and vehicle discovery succeeded.waiting_for_vehicle_datameans the credentials were retained but runtime readiness did not arrive within the bounded check. - Confirm the vehicle card shows the new estimated date and no
reauth_requiredstate. - Confirm the sidebar updates without a browser reload and live telemetry reconnects.
- Check application logs for the vehicle-scoped refresh and worker-health events. Do not enable payload or credential logging.
If the result remains waiting, inspect worker health and Rivian API errors
before repeating authentication. A sleeping vehicle may delay telemetry, but
vehicle discovery should still succeed. Password changes, account unlinking,
permission removal, and Rivian-side revocation can invalidate credentials before
the estimate.
Release verification
After changing this behavior, verify the renewal-state boundary tests, manual credential timestamp reset, CSRF timestamp preservation, health-gated reconnect, frontend query invalidation, and live-socket reconnect. For production, also verify the immutable deployed revision and container health through the native GitOps and Komodo records.