retrieve_work_item
Retrieve a single work item from Plane using project and work item IDs, with optional expansion of related fields and filtering.
Instructions
Retrieve a work item by ID.
Args: project_id: UUID of the project work_item_id: UUID of the work item expand: Comma-separated fields to expand (e.g., "assignees,labels,state") fields: Comma-separated fields to include in response 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
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"project_id": "<project_id>",
"work_item_id": "<work_item_id>"
},
"name": "retrieve_work_item"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| expand | No | ||
| fields | No | ||
| order_by | No | ||
| project_id | Yes | ||
| external_id | No | ||
| work_item_id | Yes | ||
| external_source | No |
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 |