---
title: "Delete a backup schedule"
method: DELETE
path: "/instances/{instanceId}/backup-schedules/{id}"
tags: ["Backup Schedules"]
---

# Delete a backup schedule

`DELETE /instances/{instanceId}/backup-schedules/{id}`

## Request

- Base URL: `https://api.cloudpepper.io`
- URL: `https://api.cloudpepper.io/instances/{instanceId}/backup-schedules/{id}`
- Auth: HTTP bearer

Permanently removes a backup schedule from an instance. This stops future automatic backups from being created according to this schedule. Optionally, you can also delete all existing backups that were created by this schedule.

**Key Parameters:**
- `instanceId`: The unique identifier of the instance containing the backup schedule
- `id`: The unique identifier of the backup schedule to delete
- `deleteBackups`: Optional query parameter (boolean) to also delete all backups created by this schedule

**NOTE:** If `deleteBackups=true` is specified, all backups associated with this schedule will be permanently deleted. This operation cannot be undone, so use this option with caution.

## Query parameters

- `deleteBackups` boolean

## Response `200`

Backup schedule deleted successfully

## Other responses

- `403`: Insufficient permissions
- `404`: Instance or backup schedule not found

---

[API](https://skmtc.dev/cloudpepper/apis/cloudpepper-api-docs.md) · [All operations](https://skmtc.dev/cloudpepper/apis/cloudpepper-api-docs/llms.txt) · [OpenAPI document](https://skmtc.dev/cloudpepper/apis/cloudpepper-api-docs/revisions/b6a59274cedc?raw)