Delete meeting
delete_meetingPermanently remove a meeting and all associated data from OpenProject. Requires confirmation; use update_meeting to cancel instead.
Instructions
Permanently delete a meeting, together with its agenda and recorded outcomes.
Use only on explicit user instruction. The meeting, its agenda items, their outcomes
and its attachments all go with it, and OpenProject offers no API-side undo. If the
meeting merely did not happen, update_meeting(meeting_id=..., state='cancelled') is
the reversible alternative that keeps the record.
Returns a small confirmation object once OpenProject accepts the deletion.
Pitfalls. This needs the 'delete meetings' permission, so a 403 is about the account, not the id. A 404 means the id is wrong, the meeting was already deleted, or — on OpenProject before 17.4 — the meetings write API does not exist at all; the hint names all readings.
Cross-references: get_meeting to check what you are about to destroy;
update_meeting(state='cancelled') for the reversible alternative; list_meetings
for the id.
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. | |
| meeting_id | Yes | Numeric meeting id to delete permanently. Read it back with get_meeting first and show the user the title — meeting ids are not human-readable. |
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. |