list_work_item_enum_options
Lists valid enum options for work item fields (type, status, etc.) to ensure correct values before creating or updating work items.
Instructions
List valid enum options for a work item field of the given type.
Call this before create_work_item / update_work_item when you
need to pick a value for a work item's type / status /
severity / priority / custom enum field. Polarion does NOT
validate these values on write -- unknown ids are stored verbatim as
ghost values (priority only coerces non-numeric inputs to the
project default) -- so resolve them first. This tool covers WORK
ITEM fields only; document fields are surfaced via
list_document_enum_options.
Returns the FULL enum set for the field on the given work item type.
Workflow transitions are NOT filtered by the work item's current
state; that is a separate Polarion endpoint not exposed here.
work_item_type='~' returns the type-agnostic option set. An
unknown work_item_type is silently treated as ~ by Polarion
with no error, so verify the type id (e.g. via get_work_item)
before trusting the result.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| project_id | Yes | Polarion project ID. | |
| field_id | Yes | Field id (e.g. 'status', 'type', 'severity', 'priority', or a custom field id). | |
| work_item_type | Yes | Work item type id (e.g. 'task', 'requirement'). Pass '~' for type-agnostic options. | |
| page_size | No | Number of options per page (1-100, default 100). | |
| page_number | No | Page number to retrieve (1-based, default 1). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| items | Yes | ||
| total_count | Yes | ||
| page | Yes | ||
| page_size | Yes | ||
| has_more | No | True if more pages follow. |