> 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/end-a-shift-series.md).

# End a shift series

Stops a series. It is marked ended and generates nothing further.

#### Endpoint

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

### Fields

| Field                   | Default | Description                                                                                                                        |
| ----------------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| `end_date` or `ends_at` |         | Optional. Without one, the series ends now.                                                                                        |
| `cancel_future_shifts`  | `true`  | Cancel the shifts past the end. Leaving them behind means orphaned dates nobody is maintaining, which is rarely what anyone wants. |
| `notify_users`          | `false` | Tell the volunteers booked onto the cancelled shifts.                                                                              |
| `message`               |         | A short note for that notification.                                                                                                |

#### Payload sample

```json
{
  "cancel_future_shifts": true,
  "notify_users": true,
  "message": "This program is wrapping up. Thank you for everything."
}
```

#### Response sample

```json
{
  "series_id": "7c0f3f20-6e39-4b80-bb35-7d743f0193a6",
  "status": "ended",
  "ends_at": "2026-10-08T02:30:00Z",
  "shifts_cancelled": 52
}
```

### Why there is no delete

Ending is the only way to stop a series, and that is deliberate. A series that has been running has history behind it: shifts that happened, volunteers who attended them, hours that were logged and reported on. Deleting the series would take that with it.

Ending keeps all of it. The series stops, the past stays.

If you ended a series by mistake, [extend it](https://docs.vomevolunteer.com/resources/schedule/shift-series/write-operations/change-when-a-series-ends.md) and it becomes active again.
