Delete Shift

Changed on Nov 3, 2026

Deletes a shift by its UUID or composite recurrence ID. Use recurrenceEditOption to control the scope to delete one or many consecutive recurring shifts

OAuth Scopes: scheduling:shifts.write, time_tracking.write

delete/api/v1/scheduling/shifts/{id}

Request

Base URL
https://companySubDomain.bamboohr.com
Auth
- HTTP basic
- or OAuth 2
  Authorization code/authorize.php
  Token URL/token.php
  Scopesscheduling:shifts.write
- or OAuth 2
  Authorization code/authorize.php
  Token URL/token.php
  Scopestime_tracking.write
TypeScript
https://skmtc.dev/bamboohr/apis/bamboohr-api/docs/api/v1/scheduling/shifts/:id/delete.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

idstring uuid required

The shift UUID, or the projected shift composite ID.

Query parameters

recurrenceEditOption'instance' | 'future' | 'all'

Example:future

How should the shift be deleted? Choose 'instance' for deleting a single target shift, 'future' for deleting the target shift and all following shifts that are in the same recurrence, 'all' for deleting all shifts starting from now that are in the same recurrence as the target shift.

Response

Shift deleted successfully. No content returned.

Changes

Nov 3, 2026922fc15f43a7 Revision changes
- info
  the security scope scheduling:shifts.write was added to the endpoint's security scheme oauth
- info
  the security scope time_tracking.write was removed from the endpoint's security scheme oauth

Operation history