Canceling pending posts

The CANCEL method allows you to delete from the system both queued posts and job postings pending completion (Those requests that return a PCP).

You use the ids passed back during the posting process to identify which posts you want to delete. Depending on the results of the posting, you'll get either queue ids (If the posting was completely successful) or posting ids (If there was a not critical error, and the posting configuration allows for the PCP to be generated.

Take into account that queued posts are usually processed within 5 minutes, if the user is allowed to post directly - this depends on the posting authorization policies in idibu - so they're more likely to result in a failed attempt to cancel. Job postings do not get deleted until the consultant completes the posting (By accessing the PCP).

This is an example payload for the cancel request:

<?xml version="1.0" encoding="UTF-8"?>
<idibu>
 <method>cancel</method>
 <postqueue>
  <queue id="1079" />
  <queue id="1023" />
 </postqueue>
 <jobpostings>
  <posting id="229" />
  <posting id="230" />
  <posting id="235" />
 </jobpostings>
</idibu>

It allows for the cancellation of either postings or queued posts in the same request. You should provide at least one tag with a valid id on it. IDs are provided in the response to a valid request.

When making a cancel request, the system responds back the results of processing the request. It is possible to get back a message with mixed results, like this:

<?xml version="1.0" encoding="UTF-8" ?>
<idibu>
  <queue status="cancelled" id="1079">The stated record has been deleted/cancelled</queue>
  <queue status="failed" id="1023">No record with the stated ID was found</queue>
  <posting status="cancelled" id="229">The stated record has been deleted/cancelled</posting>
  <posting status="cancelled" id="230">The stated record has been deleted/cancelled</posting>
  <posting status="failed" id="235">No record with the stated ID was found</posting>
</idibu>

Wherever a job board gives such an opportunity, one can also delete a job.