Skip to main content
DELETE
/
v1
/
squids
/
{squid_hash}
Delete Squid
curl --request DELETE \
  --url https://api.lobstr.io/v1/squids/{squid_hash} \
  --header 'Authorization: <authorization>'
{
  "id": "<string>",
  "object": "<string>",
  "deleted": true
}
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

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

​
Query Parameters

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

​
Response Field Explanations

​
id
string
The deleted squid’s identifier. Example: "5b071952127e47d2adc8d684ff24dbd2"
​
object
string
Always “squid”. Example: "squid"
​
deleted
boolean
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
}