Pause a Scraper Studio job
Manage jobs
Pause a Scraper Studio job
POST /dca/jobs//pause temporarily stops a running Bright Data Scraper Studio job. The job moves to paused and returns the plain text response OK.
POST
Pause a Scraper Studio job
Temporarily stop a running Bright Data Scraper Studio job. The job stops processing new inputs and moves to
Use the returned
paused, and you can restart it later with Resume a Scraper Studio job.
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 pause:id value as the job_id path parameter. See List Scraper Studio jobs for the full parameter list.
When to use this endpoint
- Hold a large batch during a target site incident, then resume once the site recovers
- Free concurrency for higher-priority work during a maintenance window
- Stop a job that is returning a high rate of
blockedordetect_blockerrors while you adjust country, session or rate settings
Related
- Resume a Scraper Studio job: restart a job paused with this endpoint
- Cancel a Scraper Studio job: stop a job permanently instead of temporarily
- List Scraper Studio jobs: find the
job_idto pass to this endpoint - Get job metadata: confirm the job status after pausing
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 pause
Response
Job paused successfully
The response is of type string.