GET/api/v1/meetings

List meetings

The meetings of a workspace you can open, a page at a time, newest first. Each is a card: title, date (the day it happened) and time, series, type, the first five attendees and attendee_count, slug and transcript_slug, a line of the AI summary, the decisions, action_items and open_questions counts, cover, restricted, how it came in (source: manual, auto or mcp) and its AI summary's state (ai). Get one meeting for the rest. When next_cursor is set, pass it back as cursor with the same filters and sort for the next page. The first page also has total (how many match) and, for a workspace admin with no filter, hidden: meetings restricted from them, without a title, so they can delete them. Answers carry an ETag; send it as If-None-Match to get 304 when nothing changed.

API token required240 per minute per IPMCP: list_meetings

Guide: Meetings

Code samples and Try it

Query parameters

#
  • workspacestringRequired

    The workspace's id. Up to 40 characters.

  • limitinteger

    How many per page (1-100, default 30). From 1 to 100. Default 30.

  • cursorstring

    The previous page's next_cursor. Up to 600 characters.

  • sort"date_desc" | "date_asc" | "title" | "imported"

    date_desc (default: meeting date, newest first), date_asc (oldest first; meetings without a date last either way), title (A to Z, any case) or imported (most recently imported first). Default "date_desc".

  • qstring

    Only meetings whose title, series or an attendee's name contains this. Up to 100 characters.

  • source"manual" | "auto" | "mcp"

    Only meetings that came in this way: manual (the website), auto (Connect Google Meet) or mcp (an AI app).

  • sincestring

    Only meetings on or after this date (YYYY-MM-DD). Up to 10 characters.

  • untilstring

    Only meetings on or before this date (YYYY-MM-DD). Up to 10 characters.

  • seriesstring

    Only this series (any case), or none for meetings without one. Up to 60 characters.

  • spacestring

    all | company | team:<id> | project:<id> (Teams) Up to 40 characters.

Responses

#
  • 200OK.
  • 401No token, or the token is revoked or mistyped.
  • 422The request didn't validate. detail lists each problem, with where it is (loc) and why (msg).
  • 429Too many requests from your IP address. Wait the seconds in Retry-After.
Did this page help?