---
title: "Change a deployment's automatic backup schedule"
method: POST
path: "/backups/schedule/{id}"
tags: ["Platform"]
---

# Change a deployment's automatic backup schedule

`POST /backups/schedule/{id}`

## Request

- Base URL: `https://api.imprezahost.com/v1`
- URL: `https://api.imprezahost.com/v1/backups/schedule/{id}`
- Auth: API key in header `X-API-Key` and API key in header `X-API-Secret`

Every field is optional; anything omitted keeps its current value.

Automatic copies beyond `keep` are removed only after a NEWER one has
completed and been verified — never before. Backups started by hand
are never pruned automatically.

## Path parameters

- `id` string, required

## Request body

- object
  - `enabled` boolean
  - `frequency` 'daily' | 'weekly'
  - `keep` integer

## Response `200`

The schedule after the change

## Other responses

- `400`: frequency or keep out of range
- `401`: Invalid or missing API credentials
- `404`: Resource not found

---

[API](https://skmtc.dev/imprezahost/apis/impreza-host-public-api.md) · [All operations](https://skmtc.dev/imprezahost/apis/impreza-host-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/imprezahost/apis/impreza-host-public-api/revisions/db86511f604f?raw)