---
title: "Delete shifts"
method: DELETE
path: "/scheduler/v2/schedulers/{schedulerId}/shifts"
tags: ["Schedule:v2:Schedulers:Schedule:Shifts (V2):Shifts"]
---

# Delete shifts

`DELETE /scheduler/v2/schedulers/{schedulerId}/shifts`

## Request

- Base URL: `https://api.connecteam.com`
- URL: `https://api.connecteam.com/scheduler/v2/schedulers/{schedulerId}/shifts`
- Auth: one of:
  - API key in header `X-API-KEY`
  - OAuth 2
    - Client credentials
    - Token URL: `/oauth/v1/token` scopes: `schedule.delete`

Delete single or multiple shifts in a specified schedule

## Path parameters

- `schedulerId` integer, required: The unique identifier of the schedule

## Query parameters

- `notifyUsers` boolean, nullable: Indicates whether to send a notification to the users assigned to the shifts. This applies only to shifts that are published.

## Request body

- ShiftBulkDeleteRequest
  - `shiftsIds` string[], required: The unique identifiers of the shifts to delete

## Response `200`

Successful Response

- APIResponseV2ShiftBulkDeleteResponse
  - `requestId` string
  - `data` ShiftBulkDeleteResponse, required
    - `shiftsIds` string[], required: The IDs of the deleted shifts

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/connecteam/apis/connecteam-api-documentation.md) - [All operations](https://skmtc.dev/connecteam/apis/connecteam-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/connecteam/apis/connecteam-api-documentation/revisions/a01dde7c27fb?raw)