> ## 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.

# Update Squid Chain

> Update the chain configuration for a squid

Updates settings on an existing chain configuration. Only the fields you include in the request body are updated.

<Note>
  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.
</Note>

## Path Parameters

<ParamField path="id" type="string" required>
  Hash ID of the source squid. Example: `"e86b29c032024b66aff529e1d43c2bd7"`
</ParamField>

## Headers

<ParamField header="Authorization" type="string" required>
  Your API authentication token. Value: `Token YOUR_API_KEY`
</ParamField>

<ParamField header="Content-Type" type="string" required>
  Must be application/json. Value: `application/json`
</ParamField>

## Request Body

<ParamField body="autostart" type="boolean">
  Whether downstream runs start automatically on task queue.
</ParamField>

<ParamField body="cluster_name" type="string">
  Update the name of the target squid.
</ParamField>

<ParamField body="cluster_concurrency" type="integer">
  Update the concurrency of the target squid.
</ParamField>

## Code Examples

<CodeGroup>
  ```bash cURL theme={null}
  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
    }'
  ```

  ```python Python theme={null}
  import requests

  url = "https://api.lobstr.io/v1/squids/e86b29c032024b66aff529e1d43c2bd7/chain"
  headers = {
      "Authorization": "Token YOUR_API_KEY",
      "Content-Type": "application/json"
  }
  payload = {
      "autostart": False,
      "cluster_concurrency": 5
  }

  response = requests.patch(url, headers=headers, json=payload)
  print(response.json())
  ```
</CodeGroup>

## Response

```json 200 theme={null}
{
  "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"
}
```

```json 404 theme={null}
{
  "error": "No chain configured on this squid."
}
```