Skip to content
Squid

Delete Squid

Permanently delete a squid and all its associated data from your account

The v1 API, for batchesSquids, tasks and runs: many calls on a schedule, delivered where you work. For one call that answers in seconds, use the API v2.
DELETEhttps://api.lobstr.io/v1/squids/{squid_hash}

This endpoint permanently deletes a specified squid and all its associated data (tasks, results, and configurations) from lobstr.io.

What Gets Deleted

When you delete a squid, the following are permanently removed:

  • The squid itself and all its settings
  • All tasks (URLs and parameters)
  • All results and run history
  • All configuration (parameters, integrations, schedule)
  • Any pending or active runs

Headers

Authorizationstringheaderrequired

Your API authentication token. Value: Token YOUR_API_KEY

Path Parameters

squid_hashstringpathrequired

The unique identifier (hash) of the squid to delete. Example: 5b071952127e47d2adc8d684ff24dbd2

Response Field Explanations

idstring

The deleted squid's identifier. Example: "5b071952127e47d2adc8d684ff24dbd2"

objectstring

Always "squid". Example: "squid"

deletedboolean

Boolean confirming deletion (always true on success). Example: true

This action is permanent and cannot be undone. Make sure you've downloaded any important results before deleting.

If you just want to pause a squid temporarily, set 'is_active: false' using Update Squid instead of deleting it.

Deleting a squid does not affect your credits or billing. Any credits spent on runs remain consumed.

Use the Empty Squid endpoint if you want to clear tasks but keep the squid configuration for future use.

If a run is currently active, the deletion will stop the run and then delete the squid. Any partial results will be lost.

Code Examples

curl -X DELETE "https://api.lobstr.io/v1/squids/5b071952127e47d2adc8d684ff24dbd2" \
  -H "Authorization: Token YOUR_API_KEY"

Response

200
{
  "id": "5b071952127e47d2adc8d684ff24dbd2",
  "object": "squid",
  "deleted": true
}