> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify.com/firecrawl/firecrawl/llms.txt
> Use this file to discover all available pages before exploring further.

# Cancel batch scrape

> Cancel a batch scrape job

## Endpoint

<CodeGroup>
  ```http theme={null}
  DELETE /v1/batch/scrape/{id}
  ```
</CodeGroup>

## Authentication

This endpoint requires authentication using a Bearer token. Include your API key in the Authorization header:

```
Authorization: Bearer YOUR_API_KEY
```

## Path Parameters

<ParamField path="id" type="string" required>
  The ID of the batch scrape job to cancel (UUID format)
</ParamField>

## Response

<ResponseField name="success" type="boolean">
  Indicates whether the batch scrape job was successfully cancelled
</ResponseField>

<ResponseField name="message" type="string">
  Confirmation message
</ResponseField>

## Examples

<CodeGroup>
  ```bash cURL theme={null}
  curl -X DELETE https://api.firecrawl.dev/v1/batch/scrape/550e8400-e29b-41d4-a716-446655440000 \
    -H 'Authorization: Bearer YOUR_API_KEY'
  ```

  ```python Python theme={null}
  from firecrawl import FirecrawlApp

  app = FirecrawlApp(api_key='YOUR_API_KEY')

  job_id = '550e8400-e29b-41d4-a716-446655440000'
  result = app.cancel_batch_scrape(job_id)

  if result['success']:
      print(result['message'])
  else:
      print("Failed to cancel batch scrape job")
  ```

  ```javascript JavaScript theme={null}
  import FirecrawlApp from '@mendable/firecrawl-js';

  const app = new FirecrawlApp({ apiKey: 'YOUR_API_KEY' });

  const jobId = '550e8400-e29b-41d4-a716-446655440000';
  const result = await app.cancelBatchScrape(jobId);

  if (result.success) {
    console.log(result.message);
  } else {
    console.log('Failed to cancel batch scrape job');
  }
  ```
</CodeGroup>

## Success Response

```json theme={null}
{
  "success": true,
  "message": "Batch scrape job successfully cancelled."
}
```

## Error Responses

<ResponseField name="404" type="object">
  **Not Found** - Batch scrape job not found.

  ```json theme={null}
  {
    "error": "Batch scrape job not found."
  }
  ```
</ResponseField>

<ResponseField name="500" type="object">
  **Server Error** - An unexpected error occurred on the server.

  ```json theme={null}
  {
    "error": "An unexpected error occurred on the server."
  }
  ```
</ResponseField>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.