Delete Batch

delete batch batches can be deleted by making an http delete request to the /batches/batch id endpoint (where batch id is the id of the batch you wish to delete) a batch can only be deleted under certain condidtions a batch cannot be deleted if it is currently running a batch cannot be deleted if any results within it have a webhook status of "failed", unless force=true if force=true , the batch will be deleted even if there are webhook failures to check whether a batch is currently running use the get batch https //docs trajectdata com/serpwow/batches api/batches/get endpoint to check whether a webhook has failed, use the get result set docid\ vech8qynmvyjtn8ns0dqf endpoint example delete delete /batches/batch id in the example below we delete a batches with id=123456 $ curl x delete "https //api serpwow\ com/live/batches/123456?api key=demo"const axios = require('axios'); const params = { api key 'demo' } axios delete('https //api serpwow\ com/live/batches/123456', { params }) then(response => { console log('batch deleted '); }) catch(error => { console log(error); });import requests api result = requests delete('https //api serpwow\ com/live/batches/123456?api key=demo') print ("batch deleted ")\<?php $querystring = http build query(\[ 'api key' => 'demo', ]); $ch = curl init(sprintf('%s?%s', 'https //api serpwow\ com/live/batches/123456', $querystring)); curl setopt($ch, curlopt returntransfer, true); curl setopt($ch, curlopt followlocation, true); \# the following options are required if you're using an outdated openssl version \# more details https //www openssl org/blog/blog/2021/09/13/letsencryptrootcertexpire/ curl setopt($ch, curlopt ssl verifyhost, false); curl setopt($ch, curlopt ssl verifypeer, false); curl setopt($ch, curlopt timeout, 180); curl setopt($ch, curlopt customrequest, "delete"); $json = curl exec($ch); curl close($ch); echo "batch deleted ", php eol; ?> serpwow responds with a json object confirming that the batch has been deleted, or detailing the error if it has not been possible to delete the batch { "request info" { "success" true, "message" "batch deleted" } } example when webhook failed delete delete /batches/batch id?force=true in the example below we delete a batches with id=123456 $ curl x delete "https //api serpwow\ com/live/batches/123456?api key=demo\&force=true"const axios = require('axios'); const params = { api key 'demo' force 'true' } axios delete('https //api serpwow\ com/live/batches/123456', { params }) then(response => { console log('batch deleted '); }) catch(error => { console log(error); });import requests api result = requests delete('https //api serpwow\ com/live/batches/123456?api key=demo\&force=true') print ("batch deleted ")\<?php $querystring = http build query(\[ 'api key' => 'demo', 'force'=> 'true' ]); $ch = curl init(sprintf('%s?%s', 'https //api serpwow\ com/live/batches/123456', $querystring)); curl setopt($ch, curlopt returntransfer, true); curl setopt($ch, curlopt followlocation, true); \# the following options are required if you're using an outdated openssl version \# more details https //www openssl org/blog/blog/2021/09/13/letsencryptrootcertexpire/ curl setopt($ch, curlopt ssl verifyhost, false); curl setopt($ch, curlopt ssl verifypeer, false); curl setopt($ch, curlopt timeout, 180); curl setopt($ch, curlopt customrequest, "delete"); $json = curl exec($ch); curl close($ch); echo "batch deleted ", php eol; ?> as above, serpwow responds with a json object confirming that the batch has been deleted, or detailing the error if it has not been possible to delete the batch { "request info" { "success" true, "message" "batch deleted" } } next steps get batches https //docs trajectdata com/serpwow/batches api/batches/get list batches https //docs trajectdata com/serpwow/batches api/batches/list