Add meeting outcome
add_meeting_outcomeAdd meeting minutes by recording decisions, notes, or linked work packages against an agenda item in OpenProject.
Instructions
Record an outcome — a decision, a note, a follow-up ticket — against an agenda item.
This is how minutes are written through the API: "decision: ship on Friday" becomes
kind='decision' with the text in notes; linking the follow-up work package makes
it kind='work_package'. Outcomes appear under their agenda item in get_meeting.
Returns the created outcome: {id, kind, notes, author, work_package, agenda_item}.
Pitfalls — the timing rule matters most. Outcomes can only be written while the
meeting state is exactly 'in_progress': before that, and again once it is closed,
every outcome write answers a validation error. Start the meeting with
update_meeting(meeting_id=..., state='in_progress') first. Items in a backlog
section refuse outcomes the same way. This needs the 'manage outcomes' permission, so
a 403 is about the account, not the payload. On OpenProject before 17.6 there is no
outcomes API at all — the 404 hint says so.
Cross-references: get_meeting for the agenda item id and to read the outcome back;
update_meeting to put the meeting into 'in_progress'; update_meeting_outcome /
delete_meeting_outcome to correct or remove it while the meeting still runs.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | No | 'information' (a note for the minutes, requires notes), 'decision' (what was decided), or 'work_package' (the outcome IS a follow-up ticket, requires work_package_id). | information |
| notes | No | The outcome text as markdown. Required for kind='information'; optional but usually worth writing for the other kinds. | |
| agenda_item_id | Yes | Numeric agenda item id the outcome is recorded against, from get_meeting's agenda_items. Not the meeting id. | |
| work_package_id | No | Work package the outcome points at, from search_work_packages. Required for kind='work_package'; it must be visible to this account. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | Outcome id. | |
| kind | No | Outcome kind as the instance defines it, e.g. 'decision'. | |
| notes | No | Outcome text as markdown (raw); html is dropped. | |
| author | No | User who recorded the outcome. | |
| agenda_item | No | Agenda item the outcome is recorded against. | |
| work_package | No | Work package the outcome points at, when one was linked. |