Skip to main content

​
List Notes

​
page
integer
Page number (default 1)
​
per_page
integer
Items per page (default 20, max 100)
​
q
string
Full-text search query
​
from
string
Start date filter (ISO 8601)
​
to
string
End date filter (ISO 8601)
​
tag
string
Filter by tag
GET /v1/notes
List all notes for the authenticated user. Supports pagination, date filtering, and full-text search.
Response
{
  "data": [
    {
      "id": "note_abc123",
      "title": "Product Sync with Sarah",
      "summary": "Discussed Q3 roadmap priorities...",
      "created_at": "2026-06-15T14:30:00Z",
      "duration_seconds": 1820,
      "recording_id": "rec_xyz789",
      "tags": ["meeting", "product"],
      "highlights": 3
    }
  ],
  "meta": { "page": 1, "per_page": 20, "total": 142 }
}

​
Get Note

GET /v1/notes/:id
Get a single note including full transcript, summary, action items, highlights, and speaker information.
Response
{
  "id": "note_abc123",
  "title": "Product Sync with Sarah",
  "summary": "Discussed Q3 roadmap priorities...",
  "transcript": "Speaker 1: Let's start with the roadmap...",
  "action_items": [
    {
      "id": "ai_001",
      "text": "Send updated spec to Sarah",
      "assignee": "You",
      "due": "2026-06-18",
      "status": "pending"
    }
  ],
  "highlights": [
    { "id": "hl_01", "timestamp_ms": 42000, "text": "Key decision: ship V2 by July 1" }
  ],
  "speakers": [
    { "label": "Speaker 1", "name": "You" },
    { "label": "Speaker 2", "name": "Sarah Chen" }
  ],
  "tags": ["meeting", "product"],
  "created_at": "2026-06-15T14:30:00Z",
  "duration_seconds": 1820,
  "recording_id": "rec_xyz789"
}

​
Update Note

PATCH /v1/notes/:id
Update note metadata such as title or tags.
​
title
string
Updated title
​
tags
string[]
Updated tags array
Response
{
  "id": "note_abc123",
  "title": "Updated Title",
  "tags": ["updated"]
}

​
Delete Note

DELETE /v1/notes/:id
Permanently delete a note and its associated recording. This action is irreversible.
Response
{ "deleted": true }