Update backup schedule

Update a backup schedule.

PATCH /backup-schedules/{schedule_id}

curl

curl -sS -X PATCH "https://api.pinecone.io/backup-schedules/${SCHEDULE_ID}" \
  -H "api-key: ${PINECONE_API_KEY}" \
  -H "X-Pinecone-API-Version: unstable" \
  -H "Content-Type: application/json" \
  -d '{
    "enabled": false,
    "frequency": "weekly",
    "retention": { "expire_after_days": 14 }
  }'

curl

{
  "schedule_id": "c688ed12-5a39-4254-9518-bd394b7f4886",
  "name": "my-nightly-backup",
  "index_id": "d40265e4-a492-402b-9cf1-973b4908b7a0",
  "project_id": "cc95c601-bf08-4973-9a1d-a65a1b528759",
  "schedule_type": "time-based",
  "frequency": "weekly",
  "retention_expire_after_days": 14,
  "enabled": false,
  "next_scheduled_run": "2026-04-24T06:00:00+00:00",
  "created_at": "2026-04-23T16:36:51.267528+00:00"
}

This endpoint requires X-Pinecone-API-Version: unstable.

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

Path parameters

schedule_id · string · required

The ID of the backup schedule to update.

Body parameters

enabled · boolean

Whether the schedule is enabled. Set to false to pause the schedule without deleting it.

frequency · string

How often backups are created. One of daily, weekly, or monthly.

retention · object

The retention policy for backups created by this schedule.

Show retention properties

expire_after_days · integer

The number of days after which backups created by this schedule are automatically deleted.

curl

curl -sS -X PATCH "https://api.pinecone.io/backup-schedules/${SCHEDULE_ID}" \
  -H "api-key: ${PINECONE_API_KEY}" \
  -H "X-Pinecone-API-Version: unstable" \
  -H "Content-Type: application/json" \
  -d '{
    "enabled": false,
    "frequency": "weekly",
    "retention": { "expire_after_days": 14 }
  }'

curl

{
  "schedule_id": "c688ed12-5a39-4254-9518-bd394b7f4886",
  "name": "my-nightly-backup",
  "index_id": "d40265e4-a492-402b-9cf1-973b4908b7a0",
  "project_id": "cc95c601-bf08-4973-9a1d-a65a1b528759",
  "schedule_type": "time-based",
  "frequency": "weekly",
  "retention_expire_after_days": 14,
  "enabled": false,
  "next_scheduled_run": "2026-04-24T06:00:00+00:00",
  "created_at": "2026-04-23T16:36:51.267528+00:00"
}