update_work_items
Update up to 50 work items atomically by patching specified fields; list fields like assignees and hyperlinks are fully replaced.
Instructions
Update fields on 1-50 existing work items in one bulk PATCH; unset fields stay unchanged. hyperlinks/assignee_ids REPLACE the stored lists: even to add ONE entry, call get_work_item on the target BEFORE updating and resubmit every existing entry plus the new one — anything omitted is silently deleted. Atomic: one bad item rejects the whole batch.
description_html is raw Polarion HTML, sent verbatim — source from get_work_item(include_description_html=True); greenfield bodies use create_work_items Markdown, formats never mix. To add a table, caption, image, link, or widget, call get_html_recipes first and adapt its template before writing description_html — hand-written table markup is rejected. workitemimg:{id} image refs must name an existing attachment — confirm via list_work_item_attachments first.
custom_fields is partial; keys outside the type schema are rejected, values are not validated — resolve via list_work_item_enum_options first. module is not settable here — use move_work_item_to_document / move_work_item_from_document. workflow_action/change_type_to apply to EVERY item; change_type_to rescopes enums to the target type and resets status. Returns ids only — re-read via get_work_item if needed.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| items | Yes | Per-item changes (1-50). hyperlinks/assignee_ids REPLACE the stored lists — read each item first and pass full lists, not deltas. | |
| dry_run | No | Preview payload without writing; guards still query Polarion. | |
| project_id | Yes | Polarion project ID. | |
| change_type_to | No | New work-item type for EVERY item; RESETS status. | |
| workflow_action | No | Workflow action ID (e.g. 'close'); applies to EVERY item. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| dry_run | Yes | ||
| updated | Yes | ||
| work_item_ids | No | ||
| payload_preview | No |