Planner Web Services API → Item Management → Item Management Types → WorkItem
The WorkItem type represents a work item and the attributes that are set for it. This type is used as a parameter for the GetWorkItem, CreateWorkItem, UpdateItem, UpdateWorkItem methods. It is used as a member of the Item and WorkItem types. The parameters for the ItemAttribute method are:
| Parameter | Datatype | Description |
|---|---|---|
| id | int | The Id associated with the work item. |
| parentId | int | The Id associated with the parent of the work item. |
| backlogId | string | If the work item is assigned to a backlog, this parameter is the Id associated with the backlog. |
| name | string | The name given to the work item. |
| externalId | string | The Id of the work item in another system, such as SBM. |
| itemType | string | The system name of the type of the work item, as shown in the table below. |
| attributes | ItemAttribute[] | An array of key/value pairs representing the attribute set on the work item. |
System names for work item types are shown in the following table:
| Item type | System name |
|---|---|
| Defect | Agile_Defect |
| Epic | Agile_Epic |
| Story | PES-User-Story |
| Task | Agile_Task |