retrieve_work_item_by_identifier
Fetch a specific work item using its full identifier (e.g., PROJ-123). Supports optional expansion of related fields like assignees, labels, and state.
Instructions
Retrieve a work item by its full identifier (project prefix + sequence number).
The identifier must be in PROJECT-N format where PROJECT is the project's identifier string and N is the sequence number. Both parts are required.
Valid sparse fields values include: id, name, sequence_id, priority,
state, project, workspace, parent, assignees, labels, type_id,
start_date, target_date, created_at, updated_at, created_by,
updated_by, is_draft, external_source, external_id, estimate_point.
Use project (not project_id) to get the project UUID.
If you need the project UUID from a short identifier like "SHO",
use list_projects() instead - it returns id and identifier
for every project.
Args: work_item_identifier: Full work item identifier in PROJECT-N format expand: Comma-separated fields to expand (e.g., "assignees,labels,state") fields: Comma-separated sparse fieldset (see valid values above) external_id: External system identifier for filtering external_source: External system source name for filtering order_by: Field to order results by
Returns: WorkItemDetail object with expanded relationships
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| expand | No | ||
| fields | No | ||
| order_by | No | ||
| external_id | No | ||
| external_source | No | ||
| work_item_identifier | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | ||
| name | No | ||
| type | No | ||
| point | No | ||
| state | No | ||
| labels | No | ||
| parent | No | ||
| project | No | ||
| type_id | No | ||
| is_draft | No | ||
| priority | No | ||
| assignees | No | ||
| workspace | No | ||
| created_at | No | ||
| created_by | No | ||
| deleted_at | No | ||
| sort_order | No | ||
| start_date | No | ||
| updated_at | No | ||
| updated_by | No | ||
| archived_at | No | ||
| external_id | No | ||
| sequence_id | No | ||
| target_date | No | ||
| completed_at | No | ||
| estimate_point | No | ||
| external_source | No | ||
| description_html | No | ||
| description_binary | No | ||
| description_stripped | No |