> ## Documentation Index
> Fetch the complete documentation index at: https://docs.clustr-ai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Update Connector Refresh Schedule

> Set when the connectors in a slot are re-ingested

Set when the connector-refresh automation runs, and whether it runs at all. Admin only.

<Info>
  **Each fire spends credits.** A fire re-ingests every connector in a
  [slot](/api-reference/set-connector-slot) as one import job, and an import spends credits per
  connector. Weekly is the sensible default; hourly is rarely worth it.
</Info>

## Body

<ParamField body="enabled" type="boolean">
  Whether the scheduled refresh runs at all. Set `false` to pause it without emptying the slots.
</ParamField>

<ParamField body="schedule" type="object">
  <Expandable title="properties">
    <ParamField body="cadence" type="string">
      `hourly`, `daily`, `weekly` or `monthly`.
    </ParamField>

    <ParamField body="day_of_week" type="integer">
      `0` = Sunday through `6` = Saturday, for `weekly`.
    </ParamField>

    <ParamField body="day_of_month" type="integer">
      `1`-`28`, for `monthly`.
    </ParamField>

    <ParamField body="hour" type="integer">
      `0`-`23`, in `timezone`.
    </ParamField>

    <ParamField body="minute" type="integer">
      `0`-`59`.
    </ParamField>

    <ParamField body="timezone" type="string">
      IANA timezone, e.g. `Europe/Paris`.
    </ParamField>
  </Expandable>
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X PUT https://api.clustr-ai.com/api/public/connector-refresh/schedule \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "enabled": true,
      "schedule": {
        "cadence": "weekly",
        "day_of_week": 1,
        "hour": 6,
        "minute": 0,
        "timezone": "Europe/Paris"
      }
    }'
  ```

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

  requests.put(
      "https://api.clustr-ai.com/api/public/connector-refresh/schedule",
      headers={"Authorization": "Bearer YOUR_API_KEY"},
      json={
          "enabled": True,
          "schedule": {
              "cadence": "weekly",
              "day_of_week": 1,
              "hour": 6,
              "minute": 0,
              "timezone": "Europe/Paris",
          },
      },
  )
  ```

  ```javascript JavaScript theme={null}
  await fetch("https://api.clustr-ai.com/api/public/connector-refresh/schedule", {
    method: "PUT",
    headers: { Authorization: "Bearer YOUR_API_KEY", "Content-Type": "application/json" },
    body: JSON.stringify({
      enabled: true,
      schedule: { cadence: "weekly", day_of_week: 1, hour: 6, minute: 0, timezone: "Europe/Paris" },
    }),
  });
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "data": {
      "feature_key": "connector_refresh",
      "enabled": true,
      "schedule": {
        "cadence": "weekly",
        "day_of_week": 1,
        "day_of_month": 1,
        "hour": 6,
        "minute": 0,
        "timezone": "Europe/Paris"
      }
    }
  }
  ```
</ResponseExample>