Reoffering a Work Item

If a work item needs to be transferred from a user to whom it is currently allocated, but you want to reoffer it to the initial offered set rather than allocating it directly to a specific resource, you can use the unallocateWorkItem operation.

The unallocateWorkItem operation resets the work item to the Offered state, as shown in the following example.

Request:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:api="http://api.brm.n2.tibco.com">
   <soapenv:Header/>
   <soapenv:Body>
      <api:unallocateWorkItem>
         <workItemID id="3" version="16"/>
      </api:unallocateWorkItem>
   </soapenv:Body>
</soapenv:Envelope>
Response:
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
   <SOAP-ENV:Header/>
   <SOAP-ENV:Body>
      <unallocateWorkItemResponse xmlns="http://api.brm.n2.tibco.com">
         <workItem xmlns="">
            <id id="3" version="17"/>
            <header distributionStrategy="OFFER" priority="50">
               <name>DisplayMessage</name>
               <description>Display Message</description>
               <flags>
                  <scheduleStatus>DURING</scheduleStatus>
               </flags>
               <itemContext>
                  <activityID>pvm:001io</activityID>
                  <activityName>DisplayMessage</activityName>
                  <appInstance>pvm:0a123</appInstance>
                  <appName>WelcomeUsers</appName>
                  <appID>_-fPYwCIVEeCnP8eZZTCDGg</appID>
               </itemContext>
            </header>
            <state > OFFERED</state
            <visible>true</visible>
         </workItem>
      </unallocateWorkItemResponse>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Note that you cannot change the resources to which the work item is offered; you can only reallocate to the original offer set. If you need the work item to be assigned to a completely different resource you must possess the reallocateWorkItemToWorld system action and reallocate the work item using reallocateWorkItem, as described in Reallocating to Offer Set or to World.