REST API - reallocateWorkItem

The table summarizes the REST API - reallocateWorkItem.

Request

Format
PUT <baseurl>/workitem/reallocate
Query parameters
  • id=long (1..n) : Unique ID of the work item.
  • version=long (1..n): Version of the work item. If not set, the latest version will be used.
  • resources=string : Name of the resource to whom the specified work item should be reallocated.
  • revertdata=boolean: Boolean that defines whether the data associated with the specified work item is to be reverted or not.

Note: All these parameters can be multiples. Id and version must be pairs. For example:

id=1&id=2&id=3&version=1&version=2&version=3

Response

JSON Returns a JSON representation of the content of the reallocateWorkItemResponse element.
XML Returns the content of the reallocateWorkItemResponse element (from the WorkItemManagementService schema)

Example

Request
PUT <baseurl>/workitem/reallocate?id=3&version=1&resources=tibco-admin&revertdata=true
Response
{
    "workItem": {
        "id": {
            "@id": "3",
            "@version": "2"
        },
        "header": {
            "@distributionStrategy": "OFFER",
            "@priority": "50",
            "@startDate": "2013-01-22T14:10:13.047Z",
            "name": "DisplayMessage",
            "description": "Display Message",
            "flags": {
                "scheduleStatus": "DURING"
            },
            "itemContext": {
                "activityID": "pvm:001ip",
                "activityName": "DisplayMessage",
                "appInstance": "pvm:0a124",
                "appName": "WelcomeUsers",
                "appID": "_-fPYwCIVEeCnP8eZZTCDGg"
            }
        },
        "state": "ALLOCATED",
        "visible": true
    }
}