Skip to main content

Deleting posts

You may send in requests to delete the adverts for a particular job. In order to delete adverts, a valid Job ID or Client Reference needs to be provided.

Deleting all posts for a job​

This is an example XML file for a delete request:

<idibu>
    <METHOD>DELETE</METHOD>
    <JOB ID="425" />
</IDIBU>

This request will delete all successful postings for that job (Note, this can only be performed on job boards that support the delete function). Take into account that delete takes precedence over adding a job, so if the method tag is set to "delete" whatever is in the request that is not related to the delete request will not be processed.

Deleting specific posts for a job​

If you want to delete postings for 1 or more particular boards for a certain job, you can do that using an XML format as below:

<idibu>
<METHOD>DELETE</METHOD>
    <JOB ID="31002847">
    <POSTS>
    <BOARD ID="10" />
    <BOARD ID="54" />
    </POSTS>
    </JOB>
</IDIBU>

Response messages for delete requests​

Below you will find various examples of the possible system response messages:

Succesful delete request message​

<?xml version="1.0" encoding="UTF-8"?>
<IDIBU>
<JOB ID="31002847">
<POST STATUS="PENDING" TYPE="Del" BOARDID="54" REMOTEID="something" QUEUEID="847">Job was posted for deletion to this board.</POST></JOB>
</IDIBU>

No posts were found suitable for delete​

<?xml version="1.0" encoding="UTF-8"?>
<IDIBU>
<JOB ID="31002847">
<ERROR>No posts suitable for deletion were found for the stated job</ERROR></JOB>
</IDIBU>

Mixed response when board ids are provided​

<?xml version="1.0" encoding="UTF-8"?>
<IDIBU>
<JOB ID="31002847">
<POST BOARDID="10" STATUS="FAILED">No posts suitable for deletion were found for this board</POST>
<POST STATUS="PENDING" TYPE="Del" BOARDID="54" REMOTEID="something" QUEUEID="853">Job was posted for deletion to this board.</POST></JOB>
</IDIBU>

Reference-based delete​

You can also delete your clients' ads based on the job's reference alone - sending a single request will then remove the ad from all portals where that is possible. However, we recommend using this option ONLY if your system is based on a unique reference for each job. Otherwise, you may end up removing posts that were not intended for the deletion requested.

By default, this method has a failsafe that will throw an error in case a particular reference is connected to more than one job id. However, this failsafe can be avoided by adding the all=yes parameter. Please note that it is the partner's responsibility to build a system that won't accidentally delete any posts that should not be deleted using this method.

<?xml version="1.0" encoding="UTF-8"?>
<idibu>
	<method>delete</method>
	<job ref="JO-1404-7731" all="yes"></job>
</idibu>

You can also provide multiple references for deletion using a ;!; sepator:

<?xml version="1.0" encoding="UTF-8"?>
<idibu>
	<method>delete</method>
	<job ref="JO-1404-7731;!;JO-1404-7732;!;JO-1404-7733" all="yes"></job>
</idibu>