Delete Squid
curl --request DELETE \
--url https://api.lobstr.io/v1/squids/{squid_hash} \
--header 'Authorization: <authorization>'import requests
url = "https://api.lobstr.io/v1/squids/{squid_hash}"
headers = {"Authorization": "<authorization>"}
response = requests.delete(url, headers=headers)
print(response.text)const options = {method: 'DELETE', headers: {Authorization: '<authorization>'}};
fetch('https://api.lobstr.io/v1/squids/{squid_hash}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.lobstr.io/v1/squids/{squid_hash}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "DELETE",
CURLOPT_HTTPHEADER => [
"Authorization: <authorization>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.lobstr.io/v1/squids/{squid_hash}"
req, _ := http.NewRequest("DELETE", url, nil)
req.Header.Add("Authorization", "<authorization>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.delete("https://api.lobstr.io/v1/squids/{squid_hash}")
.header("Authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.lobstr.io/v1/squids/{squid_hash}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Delete.new(url)
request["Authorization"] = '<authorization>'
response = http.request(request)
puts response.read_body{
"id": "<string>",
"object": "<string>",
"deleted": true
}Squid
Delete Squid
Permanently delete a squid and all its associated data from your account
DELETE
/
v1
/
squids
/
{squid_hash}
Delete Squid
curl --request DELETE \
--url https://api.lobstr.io/v1/squids/{squid_hash} \
--header 'Authorization: <authorization>'import requests
url = "https://api.lobstr.io/v1/squids/{squid_hash}"
headers = {"Authorization": "<authorization>"}
response = requests.delete(url, headers=headers)
print(response.text)const options = {method: 'DELETE', headers: {Authorization: '<authorization>'}};
fetch('https://api.lobstr.io/v1/squids/{squid_hash}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.lobstr.io/v1/squids/{squid_hash}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "DELETE",
CURLOPT_HTTPHEADER => [
"Authorization: <authorization>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.lobstr.io/v1/squids/{squid_hash}"
req, _ := http.NewRequest("DELETE", url, nil)
req.Header.Add("Authorization", "<authorization>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.delete("https://api.lobstr.io/v1/squids/{squid_hash}")
.header("Authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.lobstr.io/v1/squids/{squid_hash}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Delete.new(url)
request["Authorization"] = '<authorization>'
response = http.request(request)
puts response.read_body{
"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
string
required
Your API authentication token. Value:
Token YOUR_API_KEYPath Parameters
string
required
The unique identifier (hash) of the squid to delete. Example:
5b071952127e47d2adc8d684ff24dbd2Response Field Explanations
string
The deleted squid’s identifier. Example:
"5b071952127e47d2adc8d684ff24dbd2"string
Always “squid”. Example:
"squid"boolean
Boolean confirming deletion (always true on success). Example:
trueThis 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"
import requests
squid_id = "5b071952127e47d2adc8d684ff24dbd2"
url = f"https://api.lobstr.io/v1/squids/{squid_id}"
headers = {
"Authorization": "Token YOUR_API_KEY"
}
response = requests.delete(url, headers=headers)
result = response.json()
print(f"Squid deleted: {result['deleted']}")
print(f"Squid ID: {result['id']}")
print("All associated tasks, results, and configurations have been permanently removed.")
Response
200
{
"id": "5b071952127e47d2adc8d684ff24dbd2",
"object": "squid",
"deleted": true
}