Meetings API

Endpoints

All endpoints require authentication and meetings tool permission.

List Meetings

GET /api/meetings

Query parameters:

Param	Type	Description
page	number	Page number (default: 1)
per_page	number	Items per page (default: 20, max: 50)
category	string	Filter by AI category
entity_type	string	Filter by matched entity type
entity_id	string	Filter by matched entity ID
attendee_user_id	string	Filter by attendee user ID
unmatched	boolean	Show only unmatched meetings
date_from	string	Filter from date (ISO 8601)
date_to	string	Filter to date (ISO 8601)
search	string	Search title and summary

Response includes visibility scoping based on user’s access level.

Get Meeting

GET /api/meetings/:id

Returns meeting detail with attendees, action items, and match info.

Get Meeting Transcript

GET /api/meetings/:id/transcript

Lazy-fetches transcript from Granola API and caches in D1. Returns cached version on subsequent requests.

Match Meeting

POST /api/meetings/:id/match

Requires can_update permission.

Body:

{
  "entity_type": "company",
  "entity_id": "abc123"
}

Unmatch Meeting

POST /api/meetings/:id/unmatch

Clears the matched entity.

Update Action Item Status

POST /api/meetings/:id/action-items/:actionId/status

Body:

{
  "status": "done"
}

Valid statuses: pending, done, dismissed.

Re-analyse Meeting

POST /api/meetings/:id/reanalyse

Triggers AI re-categorisation. Returns 202 Accepted.

Meeting Stats

GET /api/meetings/stats

Returns { unmatched_count: number } for sidebar badge.

Admin Endpoints

Require admin access.

Trigger Sync

POST /api/admin/connections/granola/sync

Returns 202 Accepted. Sync runs in the background.

Sync Status

GET /api/admin/connections/granola/status

Returns:

{
  "connected": true,
  "last_synced_at": "2026-03-27T10:00:00Z",
  "sync_interval_minutes": 5,
  "sync_enabled": true,
  "total_notes": 247,
  "unmatched_count": 12
}

Database Tables

• meetings — Core meeting data (PK: Granola note ID)
• meeting_attendees — Attendees with email→user resolution
• meeting_transcripts — Cached transcripts (lazy-fetched)
• meeting_action_items — AI-extracted and manual action items