How to remove a job

The user has downloaded the results of a job and wants to delete it.

Deleting a job will remove the results and errors resources. Also the job is no more listed in list of jobs GET /batch/jobs, but with the jobId it is still possible to request the metadata.

📘

Note

Jobs are automatically deleted from the server 30 days after they are created. Jobs metadata is automatically removed 60 days after they are created.

Request

The following DELETE request uses the jobId from an earlier request to remove its results and errors from the server.

You need to use the jobId from your own request.

DELETE  https://batch.search.hereapi.com/v7/batch/jobs/<jobId>

With cURL assuming jobId is in environment from earlier request. You also have to set YOUR_API_KEY variable.

curl --request 'DELETE' \
  "https://batch.search.hereapi.com/v7/batch/jobs/${jobId}?apiKey=${YOUR_API_KEY}" \
  --header 'accept: application/json'

Response

{
  "id": "<jobId>",
  "serviceHrn": "hrn:here:service::olp-here:search-geocode-7",
  "billingTags": [],
  "status": "deleted",
  "href": "https://batch.search.hereapi.com/v7/batch/jobs/<jobId>"
}

Related information

• API endpoints
• Geocoding
• Job
• Job status
• Reverse geocoding