Cancel a Scraper Studio job
Manage jobs
Cancel a Scraper Studio job
POST /dca/jobs//cancel permanently stops a Bright Data Scraper Studio job. The job moves to canceled and cannot be resumed afterward.
POST
Cancel a Scraper Studio job
Permanently stop a Bright Data Scraper Studio job. The job moves to
Use the returned
canceled and stops processing its remaining inputs.
This endpoint takes no request body and returns the plain text body OK on success, not JSON. Read the response as text rather than calling a JSON parser on it.
Job state behavior
Completed jobs cannot be paused, resumed or canceled.
How to find a job ID
Use the jobs list endpoint to find the ID of the job you want to cancel:id value as the job_id path parameter. See List Scraper Studio jobs for the full parameter list.
When to use this endpoint
- Stop a job triggered with the wrong input set instead of paying for the full run
- Cancel a runaway job generating far more child pages than expected, rather than waiting for a
too_many_pageserror - Clear a stuck job before triggering a corrected run of the same scraper
aborted_page error code. See Scraper Studio error codes for the full catalog.
Related
- Pause a Scraper Studio job: stop a job temporarily instead of permanently
- Resume a Scraper Studio job: restart a paused job, which is not possible after canceling
- Get job metadata: confirm the job status after canceling
- Trigger async batch collection: start a corrected run
Authorizations
Use your Bright Data API Key as a Bearer token in the Authorization header.
How to authenticate:
- Obtain your API Key from the Bright Data account settings at https://brightdata.com/cp/setting/users
- Include the API Key in the Authorization header of your requests
- Format:
Authorization: Bearer YOUR_API_KEY
Example:
Learn how to get your Bright Data API key: https://docs.brightdata.com/api-reference/authentication
Path Parameters
ID of the job to cancel
Response
Job canceled successfully
The response is of type string.