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

# Delete shift

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

## Request

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

Delete a single shift by its unique ID

## Path parameters

- `shiftId` string, required: The ID of the shift to delete
- `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.

## Response `200`

Successful Response

- APIResponseV2ShiftDeleteResponse
  - `requestId` string
  - `data` ShiftDeleteResponse, required
    - `shiftId` string, required: The ID of the deleted shift

## 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)