List recurring meetings
list_recurring_meetingsList recurring meeting series, showing repetition rules and series IDs. Use it to discover regular meetings and get IDs for managing or deleting recurring series.
Instructions
List recurring meeting series — the repetition rules, not the individual meetings.
Use it to answer "what regular meetings do we have" and to find the series id that
get_recurring_meeting, the occurrence tools and delete_recurring_meeting need.
Series ids are their own id space: a series id is never a meeting id, and the weekly
occurrences themselves show up in list_meetings, not here.
Returns the standard list envelope: rows of {id, title, project, start_time, time_zone, frequency, interval, monthly_day, monthly_ordinal, monthly_weekday, end_after, end_date, iterations, duration_hours, location} plus pagination and
notes.
Pitfalls. The listing is instance-wide — the endpoint takes no project filter, so
scope by reading project on the rows. duration_hours is per occurrence. Recurring
meetings are 17.4+ AND a module: where the API predates them, the module is off, or
this account may not read meetings, the call still SUCCEEDS with an empty items and
the reason in notes — read notes before saying there are no recurring meetings.
Cross-references: get_recurring_meeting(recurring_meeting_id=...) for the schedule
with its next occurrences; create_recurring_meeting to start a series;
list_meetings for the instantiated occurrences.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | 1-based page number. | |
| page_size | No | Series per page (max 100). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sums | No | Present only when show_sums was requested. | |
| items | No | The page of results. | |
| notes | No | Degradation markers: capped aggregations, unavailable modules, … | |
| groups | No | Present only when group_by was requested. | |
| pagination | Yes | Total/page/page_size/has_more. |