update_work_items
Update fields on multiple work items in one bulk PATCH. Pass full hyperlink and assignee lists to avoid data loss, and optionally apply workflow transitions or change work item type.
Instructions
Update fields on 1-50 existing work items in one bulk PATCH; unset fields stay unchanged. Per-item 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.
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. New table, caption, link, or widget HTML must be adapted from get_html_recipes templates, never hand-written. custom_fields is partial, keys outside the type schema rejected, values NOT validated — resolve via list_work_item_enum_options first.
module not settable here — use move_work_item_to_document / move_work_item_from_document. workflow_action/change_type_to apply to EVERY item; each item needs ≥1 body field (else 400); change_type_to scopes status/severity/resolution to the target type and resets status. Unknown enum ids and missing/duplicate work_item_ids raise ValueError. Atomic: one bad item rejects the whole batch. 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 |