Skip to main content
DELETE
/
v1
/
tasks
/
{task_hash}
Delete Task
curl --request DELETE \
  --url https://api.lobstr.io/v1/tasks/{task_hash} \
  --header 'Authorization: <authorization>'
{
  "id": "<string>",
  "object": "<string>",
  "deleted": true
}

Documentation Index

Fetch the complete documentation index at: https://docs.lobstr.io/llms.txt

Use this file to discover all available pages before exploring further.

This endpoint permanently deletes a specific task using its hash ID. The task and its associated data will be removed from the system.

​
Headers

​
Authorization
string
required
Your API authentication token. Value: Token YOUR_API_KEY

​
Query Parameters

​
task_hash
string
required
The unique identifier (hash) of the task to delete. Example: c5e29d2aba8b77cdc56391e7405302de

​
Response Field Explanations

​
id
string
The deleted task’s identifier. Example: "c5e29d2aba8b77cdc56391e7405302de"
​
object
string
Always “task”. Example: "task"
​
deleted
boolean
Confirmation of deletion (true on success). Example: true
This action is permanent and cannot be undone. Task data and results will be lost.
Use Get Task first to verify you’re deleting the correct task.
Deleting a task does not affect results that have already been exported or delivered.
To remove all tasks from a squid, use the Empty Squid endpoint instead of deleting tasks one by one.

​
Code Examples

curl -X DELETE "https://api.lobstr.io/v1/tasks/c5e29d2aba8b77cdc56391e7405302de" \
  -H "Authorization: Token YOUR_API_KEY"

​
Response

200
{
  "id": "c5e29d2aba8b77cdc56391e7405302de",
  "object": "task",
  "deleted": true
}
404
{
  "error": {
    "message": "Task not found",
    "type": "not_found_error",
    "param": "task_hash"
  }
}