API key access scopes
API keys can include one or more access scopes. Any workspace member on a Business plan can create API keys. On Enterprise plans, workspace admins choose which access scopes members can use in Settings → Workspace → General → API access for members.| Access scope | What can it access |
|---|---|
| Personal notes |
|
| Public notes |
|
Obtaining an API Key
- Open the Granola desktop app
- Navigate to Settings → Connectors → API keys
- Click Create new key
- Choose the note access scopes the key should include
- Click Generate API Key
On Enterprise plans, API key access scopes must be enabled by a workspace admin in Settings → Workspace → General → API access for members.
Revoking an API Key
To revoke an API key:- Go to Settings → Connectors → API keys
- Find the key you want to revoke and click Revoke
- Confirm in the dialog
Updating an API Key
To update an API key’s access scopes:- Go to Settings → Connectors → API keys
- Find the key you want to update and click Edit
- Choose the note access scopes the key should include
- Click Save changes
Quick Start
This transcript example is from macOS. On macOS, transcript items can come
from the local microphone or from other meeting audio, so you’ll see
speaker.source = "microphone" and speaker.source = "speaker".On iOS, Granola currently returns
speaker.source = "microphone" because the
app currently captures a single audio stream. Clients should not assume that
will never expand in the future. When diarization is available,
diarization_label carries the anonymous Speaker A/B/... bucket.The API only returns notes that have a generated AI summary and transcript. Notes that are still being processed or were never summarized won’t appear in responses — the List Notes endpoint excludes them, and the Get Note endpoint returns a 404.
Rate Limits
Rate limits are applied per user or workspace, depending on the key’s access scope, to ensure fair usage and platform stability.| Metric | Value |
|---|---|
| Burst capacity | 25 requests |
| Time window | 5 seconds |
| Sustained rate | 5 requests/second (300/minute) |
429 Too Many Requests response.
