Delete Squid
Permanently delete a squid and all its associated data from your account
https://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
AuthorizationstringheaderrequiredYour API authentication token. Value: Token YOUR_API_KEY
Path Parameters
squid_hashstringpathrequiredThe unique identifier (hash) of the squid to delete. Example: 5b071952127e47d2adc8d684ff24dbd2
Response Field Explanations
idstringThe deleted squid's identifier. Example: "5b071952127e47d2adc8d684ff24dbd2"
objectstringAlways "squid". Example: "squid"
deletedbooleanBoolean 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
{ "id": "5b071952127e47d2adc8d684ff24dbd2", "object": "squid", "deleted": true }