Update meeting agenda item
update_meeting_agenda_itemEdit a meeting agenda item's title, notes, duration, position, presenter, or work package link. Only the fields you pass are changed; all others stay exactly as they are.
Instructions
Edit one agenda item: retitle it, rewrite its notes, retime, reorder or re-link it.
Use it for "give that item 20 minutes", "move it to the top" (position=1), "let
Grace present it", or to fix a wrong work-package link. Only the parameters you pass
are sent; everything else is left exactly as it is.
Returns the updated item in the same shape as add_meeting_agenda_item, including the
fresh lock_version for a follow-up edit.
Pitfalls. Once the meeting is CLOSED its agenda is frozen — every write answers a
validation error until the meeting is reopened with update_meeting(state='open').
The item's type is fixed at creation: itemType is create-only upstream, so this tool
never sends it and a simple item stays a simple item. A 422 otherwise usually means
the presenter or work package is not visible in the project — violations names the
attribute. This needs the 'manage agendas' permission (403 otherwise), and a 409 means
a concurrent edit — the error carries the fresh lock_version.
Cross-references: get_meeting for the item ids, current values and lock versions;
delete_meeting_agenda_item to remove the item; add_meeting_outcome to record what
was decided under it.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| notes | No | New markdown notes; they REPLACE the existing text, so read the current one with get_meeting first if you mean to extend it. Pass null or an empty string to clear. Omit the parameter entirely (the default) to leave it untouched. | __unchanged__ |
| title | No | New item title. Omit to leave it alone; it cannot be cleared, because simple items require one. | |
| position | No | New 1-based position within the item's section — this is how the agenda is reordered; the other items shift around it. Omit to keep the order. | |
| lock_version | No | The item's lock_version as read from get_meeting. Pass it and the write fails loudly (409) on a concurrent edit; omit it and the current version is fetched and echoed. | |
| presenter_id | No | User id of the new presenter, from search_principals or the meeting's participants. They must be able to view meetings in the project. Omit to leave the presenter alone. | |
| agenda_item_id | Yes | Numeric agenda item id from get_meeting's agenda_items (or from add_meeting_agenda_item's result). Not the meeting id, not a work package id. | |
| work_package_id | No | Re-point a work-package item at another work package, which must be visible to this account. Omit to leave the link alone; a simple item cannot be turned into a work-package one (itemType is create-only). | |
| duration_minutes | No | New planned length of this item in minutes (0-1440). Omit to leave it as it is. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | Agenda item id (not the meeting id, not a work package id). | |
| notes | No | Item notes as markdown (raw); html is dropped. | |
| title | No | Item title. Empty for a work-package item, where the work package's subject is the title shown in the UI. | |
| meeting | No | Meeting the item was added to. | |
| section | No | Agenda section the item sits in, when the meeting uses sections. | |
| outcomes | No | Outcomes recorded against this item; always a list, empty when none. | |
| position | No | 1-based order within the agenda. | |
| item_type | No | 'simple' for a free-text item, 'work_package' for a linked one. | |
| presenter | No | User presenting this item. | |
| created_at | No | ISO 8601 UTC timestamp. | |
| lock_version | No | Optimistic-lock version. Echo it as update_meeting_agenda_item's lock_version so a concurrent edit fails loudly (409) instead of being overwritten. | |
| work_package | No | Work package this item discusses. Null both when none is linked and when the linked one is invisible to this account — 'notes' says when the latter happened. | |
| duration_minutes | No | Planned length in minutes; null when the organizer set none. |