Skip to main content
PATCH
/
v1
/
squids
/
{id}
/
chain
Update Squid Chain
curl --request PATCH \
  --url https://api.lobstr.io/v1/squids/{id}/chain \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "autostart": true,
  "cluster_name": "<string>",
  "cluster_concurrency": 123
}
'
Updates settings on an existing chain configuration. Only the fields you include in the request body are updated.
If the target squid has already been created by a previous chain trigger, updating cluster_concurrency will apply the new value to that squid immediately.

​
Path Parameters

​
id
string
required
Hash ID of the source squid. Example: "e86b29c032024b66aff529e1d43c2bd7"

​
Headers

​
Authorization
string
required
Your API authentication token. Value: Token YOUR_API_KEY
​
Content-Type
string
required
Must be application/json. Value: application/json

​
Request Body

​
autostart
boolean
Whether downstream runs start automatically on task queue.
​
cluster_name
string
Update the name of the target squid.
​
cluster_concurrency
integer
Update the concurrency of the target squid.

​
Code Examples

curl -X PATCH "https://api.lobstr.io/v1/squids/e86b29c032024b66aff529e1d43c2bd7/chain" \
  -H "Authorization: Token YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "autostart": false,
    "cluster_concurrency": 5
  }'

​
Response

200
{
  "id": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4",
  "target_module": {
    "id": "9a3f1c8b2e7d4a56f0e1b2c3d4e5f678",
    "public_name": "Google Maps Reviews Scraper",
    "name": "googlemapreviews_matrix",
    "max_concurrency": 10
  },
  "target_cluster": {
    "id": "f7e8d9c0b1a2f7e8d9c0b1a2f7e8d9c0",
    "hash_value": "f7e8d9c0b1a2f7e8d9c0b1a2f7e8d9c0",
    "name": "Reviews (chained)"
  },
  "field_map": {"url": "url"},
  "is_active": true,
  "autostart": false,
  "cluster_name": "Reviews (chained)",
  "cluster_concurrency": 5,
  "created_at": "2026-04-28T10:00:00Z"
}
404
{
  "error": "No chain configured on this squid."
}