DELETE Async Batch Job enterprise only
The batch job delete service allows you to permanently delete a batch geocoding job and all associated data. This action cannot be undone.
Resource URL
Resource Information
| Response Formats | JSON |
| Authentication | Yes (Requires Key) |
| Rate Limited | Yes |
Request Parameters
| Request Parameter | Description | Required |
|---|---|---|
| key | The API Key, which is needed to make requests to MapQuest services. | Yes |
Note: The jobId is specified in the URL path, not as a query parameter.
Response Object
| id | The unique job identifier |
| status | The updated job status (typically "deleted") |
| href | The MapQuest URL of the job details |
Example Request
bash
curl -X DELETE "https://www.mapquestapi.com/geocoding/v1/batch/jobs/abc123-def456-ghi789?key=YOUR_API_KEY"Example Response
json
{
"id": "abc123-def456-ghi789",
"status": "deleted",
"href": "https://www.mapquestapi.com/geocoding/v1/batch/jobs/abc123-def456-ghi789"
}Important Notes
- HTTP Method: DELETE request to permanently remove the job
- Authentication: Same API key as other endpoints, passed as query parameter
- Job ID: The job ID is passed in the URL path, not as a query parameter
- Permanent Action: This action cannot be undone - all job data will be lost
- Status Change: Deleting a job will change its status to "deleted"
- Response Format: Returns JSON with job metadata
- Data Cleanup: All results, errors, and job metadata will be permanently removed