> For the complete documentation index, see [llms.txt](https://docs.vomevolunteer.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.vomevolunteer.com/resources/schedule/shift-series/write-operations/edit-a-shift-series.md).

# Edit a shift series

Edits the series **template**, which is the skeleton every future occurrence is built from. This is the edit that sticks. Changing a single shift changes one date; changing the template changes the series.

#### Endpoint

`POST /api/shift-series/{series_id}/update/`

### Controls

| Field                    | Default | Effect                                                                                                                  |
| ------------------------ | ------- | ----------------------------------------------------------------------------------------------------------------------- |
| `apply_to_future_shifts` | `true`  | Also rewrite the shifts Vome has already generated. Set it to `false` to change only occurrences that do not exist yet. |
| `clear_overrides`        | `false` | Also rewrite shifts that somebody edited individually. By default those keep their edits.                               |

### Editable fields

| Group                | Fields                                                                                                                                                                                                                               |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Content and capacity | `spots`, `shift_title`, `shift_description`, `shift_type`, `minimum_time`                                                                                                                                                            |
| Time of day          | `shift_start_at`, `shift_end_at`, `timezone`                                                                                                                                                                                         |
| Visibility           | `shift_visibility`, `shift_title_visibility`, `shift_description_visibility`, `shift_location_visibility`, `attendees_visibility`, `attendees_status_visibility`                                                                     |
| Group reservations   | `is_group_reservations_allowed`, `min_party_size`, `max_party_size`                                                                                                                                                                  |
| Related records      | `shift_location_id`, `shift_waitlist_policy_id`, `shift_notification_policy`, `form_submission_policy`, `group_reservation_policy`, `shift_tags`, `restrictive_tags`, `tag_restriction_rule`, `shift_coordinators`, `shift_watchers` |

Anything else is rejected, with the list of what is accepted, rather than quietly ignored.

### Times move by time of day, not by date

Send `shift_start_at` and every shift keeps its own date while the clock time moves. A series running at 7pm that you move to 6pm stays on its own dates, and each occurrence is correct through a daylight saving change rather than drifting by an hour.

### What cannot be edited

The cadence, the weekdays, and the start date. Changing any of those makes it a different series: end this one and create another. This is the same rule the Vome UI follows.

#### Payload sample

```json
{
  "spots": 15,
  "shift_title": "Evening meal service (expanded)",
  "apply_to_future_shifts": true,
  "clear_overrides": false
}
```

#### Response sample

```json
{
  "series_id": "7c0f3f20-6e39-4b80-bb35-7d743f0193a6",
  "template_updated": true,
  "shifts_updated": 52,
  "shifts_skipped_due_to_overrides": 2
}
```

The last line is the one to watch. Those two shifts were edited by hand and kept their edits. Send `clear_overrides: true` if you want the series to win.
