Skip to main content

Remove scheduled clinician from shift

POST 
/api/v2/public/scheduled-shifts/remove-clinician

Remove a Scheduled Clinician from a Shift

This operation removes a scheduled clinician from a shift under specific conditions and notifies relevant parties accordingly.

Shift Status Updates

  • If the shift has at least 1 hour remaining, it is returned to the "Open" status.
  • Otherwise, the shift is set to UnfulfilledRequested and will no longer be offered to clinicians.

Notifications

  • The removed clinician is notified about their removal from the shift.
  • If the removal reason is Remove hire refused to work:
    • The clinician's status will be updated to "frozen".
    • If the shift has started or was in progress:
      • The clinician will be removed from any other scheduled shifts if there were previous removals for No Call No Show (NCNS).

Returning the Shift to the Marketplace

  • If the shift is reopened and sent back to the marketplace:
    • Other clinicians who previously requested the shift will be notified so they can reapply.
    • Clinician candidates eligible to fill the shift will receive an SOS notification.

Request​

Body

required
    shiftId stringrequired

    The unique identifier of the shift the clinician is assigned to.

    clinicianId stringrequired

    The unique identifier of the clinician (userId) to be unscheduled from the shift.

    removalReason stringrequired

    Possible values: [Remove hire emergency, Remove hire refused to work]

    The reason for removing the clinician from the shift.

    comments stringrequired

    Comments explaining the removal (max length: 900).

Responses​

Empty Response

Loading...