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

# Update backup schedule

> Update a Pinecone backup schedule using the API, including pausing with enabled, changing frequency, and adjusting the retention expire_after_days.

<Note>
  This endpoint requires `X-Pinecone-Api-Version: 2026-07`.
</Note>

Update a backup schedule. Send only the fields you want to change. All body fields are optional.

### Path parameters

<ParamField path="schedule_id" type="string" required>
  The ID of the backup schedule to update.
</ParamField>

### Body parameters

<ParamField body="enabled" type="boolean">
  Whether the schedule is enabled. Set to `false` to pause the schedule without deleting it.
</ParamField>

<ParamField body="frequency" type="string">
  How often backups are created. One of `daily`, `weekly`, or `monthly`.
</ParamField>

<ParamField body="retention" type="object">
  The retention policy for backups created by this schedule.

  <Expandable title="retention properties">
    <ParamField body="expire_after_days" type="integer">
      The number of days after which backups created by this schedule are automatically deleted.
    </ParamField>
  </Expandable>
</ParamField>

<RequestExample>
  ```bash curl theme={null}
  curl -sS -X PATCH "https://api.pinecone.io/backup-schedules/${SCHEDULE_ID}" \
    -H "api-key: ${PINECONE_API_KEY}" \
    -H "X-Pinecone-Api-Version: 2026-07" \
    -H "Content-Type: application/json" \
    -d '{
      "enabled": false,
      "frequency": "weekly",
      "retention": { "expire_after_days": 14 }
    }'
  ```
</RequestExample>