Drop shift

PATCH {{baseUrl}}/shifts/drop

Drops a shift the driver previously claimed. Source: models/shifts.ts drop().

Response fields:

• status — ShiftResultStatus enum: Success, or IllegalShiftCancel if a runner tries to drop within 48 hours of the shift start (admins are exempt from that window).
• shift — the updated Shift row (user_id cleared, reason set).

Request body

{
  "id": "<shift-id>",
  "reason": ""
}

Examples

cURL

curl --request PATCH 'https://api.firstdelivery.com/api/shifts/drop' \
  --header 'Content-Type: application/json' \
  --data '{
  "id": "<shift-id>",
  "reason": ""
}'

Node.js

const response = await fetch("https://api.firstdelivery.com/api/shifts/drop", {
  "method": "PATCH",
  "headers": {
    "Content-Type": "application/json"
  },
  "body": "{\n  \"id\": \"<shift-id>\",\n  \"reason\": \"\"\n}"
})
const data = await response.json()

Python

import requests

response = requests.request(
    "PATCH",
    "https://api.firstdelivery.com/api/shifts/drop",
    headers={
  'Content-Type': 'application/json'
},
    data="{\n  \"id\": \"<shift-id>\",\n  \"reason\": \"\"\n}",
)
response.raise_for_status()

Saved responses

200 200 OK (Success)

{
  "status": "Success",
  "shift": {
    "id": "<shift-id>",
    "user_id": null,
    "reason": "",
    "checked_in": null,
    "start": "2026-06-23T16:00:00.000Z",
    "stop": "2026-06-23T20:00:00.000Z"
  }
}