Skip to main content
POST
/
1
/
crawlers
/
{id}
/
tasks
/
{taskID}
/
cancel
Cancel a blocking task
curl --request POST \
  --url https://crawler.algolia.com/api/1/crawlers/{id}/tasks/{taskID}/cancel \
  --header 'Authorization: Basic <encoded-value>'
{
  "error": {
    "code": "malformed_id"
  }
}
Tasks that ran into an error will block your crawler’s schedule. To unblock the crawler, cancel the blocking task.

Authorizations

Authorization
string
header
required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Path Parameters

id
string
required

Crawler ID. Universally unique identifier (UUID) of the crawler.

Example:

"e0f6db8a-24f5-4092-83a4-1b2c6cb6d809"

taskID
string
required

Task ID. Universally unique identifier (UUID) of the task.

Example:

"98458796-b7bb-4703-8b1b-785c1080b110"

Response

OK

Last modified on March 23, 2026