Delete meeting agenda item
delete_meeting_agenda_itemRemove a meeting agenda item permanently. Deletes the item and its outcomes, shifts later items up, and leaves the meeting untouched.
Instructions
Permanently delete one agenda item, with any outcomes recorded against it.
Use only on explicit user instruction. The item and its recorded outcomes disappear from the agenda for good; the items after it move up. The meeting itself is untouched.
Returns a small confirmation object once OpenProject accepts the deletion.
Pitfalls. A CLOSED meeting's agenda is frozen: the delete answers a validation error,
not a 403, until the meeting is reopened with update_meeting(state='open'). This
needs the 'manage agendas' permission. A 404 means the id is wrong, the item is
already gone — or, on OpenProject before 17.6, that the flat agenda-item write routes
do not exist; the hint names all readings.
Cross-references: get_meeting to check which item the id points at;
update_meeting_agenda_item when the item only needs fixing, not removing.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| confirm | No | Must be true. Ask the user to confirm first — the API offers no undo. Calling with confirm=false returns a confirmation_required error rather than deleting anything. | |
| agenda_item_id | Yes | Numeric agenda item id to delete, from get_meeting's agenda_items. Check the item's title there first — it is not the meeting id. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Id of the meeting, agenda item, outcome or recurring series that was deleted. | |
| deleted | Yes | True once OpenProject accepted the deletion. | |
| message | Yes | Human-readable confirmation naming what was removed. |