Delete Task

curl --request DELETE \
  --url https://api.lobstr.io/v1/tasks/{task_hash} \
  --header 'Authorization: <authorization>'

{
  "id": "<string>",
  "object": "<string>",
  "deleted": true
}

DELETE

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
}

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

task_hash

string

required

The unique identifier (hash) of the task to delete. Example: c5e29d2aba8b77cdc56391e7405302de

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.

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

200

{
  "id": "c5e29d2aba8b77cdc56391e7405302de",
  "object": "task",
  "deleted": true
}

404

{
  "error": {
    "message": "Task not found",
    "type": "not_found_error",
    "param": "task_hash"
  }
}