DELETE/v1/squids/{squid_hash}

Delete Squid

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

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

KeyValueRequired
AuthorizationToken YOUR_API_KEYYes

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

Parameters

squid_hashstring
Required
The unique identifier (hash) of the squid to delete
Example: 5b071952127e47d2adc8d684ff24dbd2
Warning

Warning

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

Pro Tip

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

Note

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

Pro Tip

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

Warning

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