How Granola handles updates
For most users, Granola keeps itself up to date automatically. While the desktop app is running, it checks for updates roughly every 10 minutes. When an update is available, Granola downloads it in the background and installs it when the app can safely restart, or when the user chooses to install the update. For auto-updates to work smoothly, users need a setup where Granola is allowed to update itself:- On macOS, Granola should be installed in the Applications folder, and the signed-in macOS user needs permission to replace the Granola app bundle.
- On Windows, Granola’s default installer is per-user, so auto-updates are most likely to work when Granola is installed somewhere the signed-in Windows user can update.
- On both platforms, the device needs network access to Granola’s update and download services.
Downloading the latest Granola installers
You can always fetch the latest public Granola installers from these unauthenticated endpoints:- macOS:
https://api.granola.ai/v1/download-latest - Windows:
https://api.granola.ai/v1/download-latest-windows
- macOS:
.dmg - Windows:
.exe
api.granola.aidr2v7l5emb758.cloudfront.net
Getting a stable, version-specific download URL
Package managers such as WinGet, FleetDM, and similar tools usually need a stable installer URL plus a matching SHA256 hash. The latest installer endpoints above always redirect to the current Granola version, so the URL they resolve to changes each time a new release ships. To pin a specific release, capture the redirect target without downloading the installer:- Poll
https://api.granola.ai/v1/get-versionsto detect new releases. - When a new version appears, use
https://api.granola.ai/v1/download-latest-windowsorhttps://api.granola.ai/v1/download-latestto get the new static CloudFront URL. - Download the installer from that CloudFront URL and compute its SHA256 hash.
- Update your package manifest with the new URL and hash.
Checking when a new version is available
To check whether there is a newer Granola release, use our public versions endpoint. No authentication is required.production version with the version you currently distribute. You can poll this endpoint on a schedule, such as daily or weekly. When the production version changes, download a fresh installer for each platform you support.
