get_work_item
Read-only
Retrieve full details of a Polarion work item, including optional HTML description for lossless round-trip editing.
Instructions
Get full details of a single Polarion work item.
With include_description_html=True the description_html field
carries the raw Polarion HTML body — the exact shape that round-trips
through update_work_item(description_html=...) losslessly. Only
feed it back when this flag was True (a False read blanks the field,
and the update tool treats "" as leave unchanged).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| project_id | Yes | Polarion project ID. | |
| work_item_id | Yes | Work Item ID (e.g. 'MCPT-001'). | |
| include_description_html | No | When True, fill ``description_html`` with raw HTML for round-trip editing. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Work Item ID (e.g. 'MCPT-001'). | |
| title | Yes | Work Item title. | |
| type | Yes | Work Item type (e.g. 'requirement', 'testCase'). | |
| status | Yes | Workflow status (e.g. 'draft', 'approved'). | |
| priority | No | Priority value as a string (e.g. '90.0'); empty when unset. | |
| updated | No | ISO-8601 last-modified timestamp; empty when unreported. | |
| space_id | No | Containing document's space; empty when free-floating. | |
| document_name | No | Containing document name; empty when free-floating. | |
| assignee_ids | No | Short user IDs of assignees; empty list when unassigned. | |
| description_html | No | Raw Polarion HTML body; empty unless the read flag was True. | |
| project_id | Yes | Project that contains this work item. | |
| author_id | No | Short user ID of the author; empty when unreported. | |
| created | No | ISO-8601 creation timestamp; empty when unreported. | |
| resolution | No | Resolution outcome (e.g. 'fixed'); empty when unresolved. | |
| severity | No | Severity classification (e.g. 'critical'); empty for non-defects. | |
| outline_number | No | Hierarchical position (e.g. '1.2.3'); empty outside a document. | |
| hyperlinks | No | External hyperlinks attached to this work item. | |
| custom_fields | No | Project-defined custom fields keyed by field ID. |