Get meeting
get_meetingRetrieve a meeting's complete details, including participants, agenda, and outcomes, to see what was discussed and decided.
Instructions
Read one meeting in full: participants, the agenda, and any recorded outcomes.
This is the "what was discussed / what was decided" call. It returns the meeting fields
(title, project, start_time, end_time, duration_hours, location, state,
author, timestamps), the invited participants as {id, name} refs, and
agenda_items in agenda order — each with its title, notes (markdown),
duration_minutes, presenter, the work_package it discusses, its section, and the
outcomes recorded against it (kind, notes, author, linked work package).
Pitfalls. A work-package agenda item carries an empty title — the work package's
subject is what the UI shows, so read work_package.name. When the linked work package
is invisible to this account, work_package is null and notes says so; do not report
the item as unlinked. If the agenda itself cannot be read (403/404 on the sub-resource),
agenda_items is empty and notes explains why — an empty agenda and an unreadable one
are different answers. Attendance, minutes as a document, and meeting sections' own
titles beyond the item link are not exposed by API v3.
Cross-references: add_meeting_agenda_item to extend the agenda; list_meetings for the
id; list_attachments(container_type='meeting', container_id=<meeting id>) for files;
get_work_package for a linked ticket. update_meeting / delete_meeting change or
remove the meeting itself — the result's lock_version is what update_meeting echoes.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| meeting_id | Yes | Numeric meeting id from list_meetings (it is also the number in a /meetings/<id> UI URL). Never a project id or an agenda item id. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | Meeting id — what get_meeting and add_meeting_agenda_item take. | |
| notes | No | Degradation notes: agenda items that could not be read, work packages this account may not see. | |
| state | No | Lifecycle state: 'draft' (not yet opened to participants), 'open', 'in_progress', 'closed' or 'cancelled'. Cancelled meetings are excluded from listings. | |
| title | No | Meeting title. | |
| author | No | User who created the meeting. | |
| project | No | Project the meeting belongs to. | |
| end_time | No | ISO 8601 UTC end timestamp, derived from start plus duration. | |
| location | No | Room name or meeting URL as typed by the organizer. | |
| created_at | No | ISO 8601 UTC timestamp. | |
| start_time | No | ISO 8601 UTC start timestamp; null for an undated meeting. | |
| updated_at | No | ISO 8601 UTC timestamp. | |
| agenda_items | No | The agenda in order; always a list. Empty means either no agenda or an unreadable one — check 'notes' before concluding the meeting had none. | |
| lock_version | No | Optimistic-lock version. Echo it as update_meeting's lock_version so a concurrent edit fails loudly (409) instead of being overwritten. | |
| participants | No | Invited users; always a list. Attendance is not exposed by API v3. | |
| duration_hours | No | Scheduled length in hours (1.5 = 90 minutes); the wire sends an ISO duration, which is converted here. |