### Example Versions Endpoint Response

Source: https://docs.granola.ai/help-center/getting-started/managed-installations

This is an example of the JSON response you will receive from the versions endpoint. Compare the 'production' version with your current distribution to detect updates.

```json
{
  "production": "7.205.0",
  "beta": "7.205.0"
}
```

--------------------------------

### Get Stable Version-Specific Download URL

Source: https://docs.granola.ai/help-center/getting-started/managed-installations

Capture the redirect target URL without downloading the installer to get a static, permanent URL for a specific Granola release. This is useful for package managers.

```bash
# macOS
curl -sI -o /dev/null -w '%{redirect_url}' "https://api.granola.ai/v1/download-latest"

# Windows
curl -sI -o /dev/null -w '%{redirect_url}' "https://api.granola.ai/v1/download-latest-windows"
```

--------------------------------

### Download Latest Granola Installers

Source: https://docs.granola.ai/help-center/getting-started/managed-installations

Use these endpoints to fetch the latest public Granola installers for macOS and Windows. Ensure your download tool follows redirects.

```bash
# macOS
curl -L -o Granola.dmg https://api.granola.ai/v1/download-latest

# Windows
curl -L -o Granola.exe https://api.granola.ai/v1/download-latest-windows
```

--------------------------------

### Note Transcript Structure (macOS)

Source: https://docs.granola.ai/

Example of the transcript structure for notes on macOS. Transcript items may indicate the source of the audio, such as 'microphone' or 'speaker'.

```json
{
  "id": "not_1d3tmYTlCICgjy",
  "title": "Quarterly yoghurt budget review",
  "owner": { "name": "Oat Benson", "email": "oat@granola.ai" },
  "summary": "The quarterly yoghurt budget review was a success. ...",
  "transcript": [
    { "speaker": { "source": "microphone" }, "text": "I'm done pretending. Greek is the only yoghurt that deserves us." },
    { "speaker": { "source": "speaker" }, "text": "Finally. Regular yoghurt is just milk that gave up halfway." }
  ],
  ...
}
```

--------------------------------

### Inspect Redirect Header for Download URL

Source: https://docs.granola.ai/help-center/getting-started/managed-installations

Inspect the redirect header directly to find the static CloudFront URL for the installer. This is an alternative method to capture the download URL.

```bash
curl -sI "https://api.granola.ai/v1/download-latest-windows" | grep -i location
```

--------------------------------

### Compute SHA256 Hash (Linux)

Source: https://docs.granola.ai/help-center/getting-started/managed-installations

Compute the SHA256 hash of the downloaded Granola installer file on Linux systems. This is required for package manager verification.

```bash
sha256sum Granola-7.205.1-win-x64.exe
```

--------------------------------

### Get Note

Source: https://docs.granola.ai/api-reference/get-note

Retrieves a specific note using its ID. You can optionally include the note's transcript in the response.

```APIDOC
## GET /v1/notes/{note_id}

### Description
Retrieves a specific note using its ID. You can optionally include the note's transcript in the response.

### Method
GET

### Endpoint
/v1/notes/{note_id}

### Parameters
#### Path Parameters
- **note_id** (string) - Required - The ID of the note. Must match the pattern ^not_[a-zA-Z0-9]{14}$

#### Query Parameters
- **include** (string) - Optional - Include the note transcript in the response. Allowed values: "transcript"

#### Request Body
None

### Response
#### Success Response (200)
- **id** (string) - The ID of the note.
- **object** (string) - The object type of the note. Enum: "note".
- **title** (string | null) - The title of the note.
- **owner** (object) - Information about the note's owner.
- **created_at** (string) - The creation time of the note.
- **updated_at** (string) - The last update time of the note.
- **web_url** (string) - The URL to view the note in the Granola web app.
- **calendar_event** (object | null) - Details about the associated calendar event.
- **attendees** (array) - A list of users who attended the meeting.
- **folder_membership** (array) - A list of folders the note belongs to.
- **summary_text** (string) - The summary text of the note.
- **summary_markdown** (string | null) - The summary of the note in markdown format.
- **transcript** (array | null) - The transcript of the note.

#### Response Example
```json
{
  "id": "not_1d3tmYTlCICgjy",
  "object": "note",
  "title": "Quarterly yoghurt budget review",
  "owner": {
    "id": "usr_abc123",
    "object": "user",
    "name": "Alice",
    "email": "alice@granola.ai"
  },
  "created_at": "2026-01-27T15:30:00Z",
  "updated_at": "2026-01-27T16:45:00Z",
  "web_url": "https://notes.granola.ai/d/f3e45e0f-24cc-480b-9a6c-8b1f5e3d7a2c",
  "calendar_event": {
    "id": "cal_xyz789",
    "object": "calendar_event",
    "title": "Yoghurt Budget Meeting",
    "start_time": "2026-01-27T15:30:00Z",
    "end_time": "2026-01-27T16:30:00Z"
  },
  "attendees": [
    {
      "name": "Oat Benson",
      "email": "oat@granola.ai"
    },
    {
      "name": "Raisin Patel",
      "email": "raisin@granola.ai"
    }
  ],
  "folder_membership": [
    {
      "id": "fol_4y6LduVdwSKC27",
      "object": "folder",
      "name": "Top secret recipes",
      "parent_folder_id": "fol_a74g2hvl98iUHG"
    }
  ],
  "summary_text": "The quarterly yoghurt budget review was a success. We spent $100,000 on yoghurt and made $150,000 in profit.",
  "summary_markdown": "## Quarterly Yoghurt Budget Review\n\nThe quarterly yoghurt budget review was a success.\n\n- Spent **$100,000** on yoghurt\n- Made **$150,000** in profit",
  "transcript": [
    {
      "speaker": {
        "source": "microphone"
      },
      "text": "I'm done pretending. Greek is the only yoghurt that deserves us.",
      "start_time": "2026-01-27T15:30:00Z",
      "end_time": "2026-01-27T16:30:00Z"
    },
    {
      "speaker": {
        "source": "speaker"
      },
      "text": "Finally. Regular yoghurt is just milk that gave up halfway.",
      "start_time": "2026-01-27T15:30:00Z",
      "end_time": "2026-01-27T16:30:00Z"
    }
  ]
}
```

#### Error Responses
- **400** - Bad request
- **401** - Unauthorized - Invalid API key
- **404** - Not found
```

--------------------------------

### List Notes Created This Week

Source: https://docs.granola.ai/

Fetches a list of notes created within the last 7 days. Requires an API key for authorization. The response includes a cursor for pagination.

```bash
$ curl "https://public-api.granola.ai/v1/notes?created_after=$(date -u -v-7d +%Y-%m-%dT%H:%M:%SZ)" \
  -H "Authorization: Bearer grn_YOUR_API_KEY"
```

--------------------------------

### List Notes Created This Week

Source: https://docs.granola.ai/introduction

Fetches a list of notes created within the last seven days. Requires an API key for authorization. The response includes a cursor for pagination.

```bash
# List notes created this week
$ curl "https://public-api.granola.ai/v1/notes?created_after=$(date -u -v-7d +%Y-%m-%dT%H:%M:%SZ)" \
  -H "Authorization: Bearer grn_YOUR_API_KEY"
{
  "notes": [ ... ],
  "hasMore": true,
  "cursor": "eyJjcmVkZW50aWFsfQ=="
}
```

--------------------------------

### Custom Transcription Terms Example

Source: https://docs.granola.ai/help-center/customising-granola/customising-transcription

Enter words and phrases to boost transcription accuracy, separated by commas. This is useful for company-specific jargon or names that might be mis-transcribed.

```text
blokk, project dolfin, tekto
```