---
search:
  tags:
    - Schedules
    - PATCH
seo:
  description: >-
    Body (any subset): frequency, timezone, local_time, start_date (edits…
    Reference for the PATCH /schedules/{schedule_id} endpoint in the Zaraftis
    Public API.
sidebar:
  label: Update a schedule
  badge: PATCH
title: Update a schedule
type: openapi-operation
---
Body (any subset): frequency, timezone, local_time, start_date (edits keep the calendar-anchored local clock), status (active|paused). Re-enabling (paused → active) re-checks the auto-reload rule first (402 otherwise).

`PATCH /schedules/{schedule_id}`

**Request body** (`application/json`, required)

- `frequency` (string)
- `timezone` (string)
- `local_time` (string)
- `start_date` (string)
- `status` (string)

Request body example:

```json
{
  "frequency": "daily",
  "timezone": "string",
  "local_time": "string",
  "start_date": "string",
  "status": "active"
}
```

**Responses**

- `200` — The schedule after the update
- `400` — bad\_request or validation\_failed
- `402` — wallet\_not\_activated, insufficient\_credits, or payment\_action\_required
- `404` — not\_found: unknown id, or an id this key cannot see