Cancel Crawl

Cancel an ongoing crawl job

DELETE /v1/crawl/

Cancel a crawl job that is currently in progress.

Authentication

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

Authorization: Bearer YOUR_API_KEY

Path Parameters

id · string · required

The ID of the crawl job to cancel (UUID format)

Response

status · string

The status after cancellation. Will be cancelled on successful cancellation.

Example Request

cURL

curl -X DELETE https://api.firecrawl.dev/v1/crawl/123e4567-e89b-12d3-a456-426614174000 \
  -H 'Authorization: Bearer YOUR_API_KEY'

Example Response

{
  "status": "cancelled"
}

Error Responses

404 Not Found

{
  "error": "Crawl job not found."
}

This error occurs when:

• The crawl ID doesn’t exist
• The crawl belongs to a different account
• The crawl has already completed or been deleted

500 Server Error

{
  "error": "An unexpected error occurred on the server."
}

Important Notes

• Cancelling a crawl will stop it immediately, and you’ll only be charged for pages that were already crawled
• You can still retrieve partial results from a cancelled crawl using the Get Crawl Status endpoint
• Once cancelled, a crawl cannot be resumed - you’ll need to start a new crawl job
• Cancelled crawls will have their status set to cancelled instead of completed or failed