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 |
|
Workspace admins on Business and Enterprise plans can also create workspace API keys. These belong to the workspace rather than an individual user, don’t expire, and can access the workspace’s public notes plus any spaces that have been granted Granola API access. See Workspace API keys for details.
Obtaining a personal 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 a personal 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 a personal 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.
