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
}
'

Documentation Index

Fetch the complete documentation index at: https://docs.lobstr.io/llms.txt

Use this file to discover all available pages before exploring further.

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."
}