scheduling

Create Shift Block

post/scheduling/shift-blocks

Request

Base URL
https://api.verdun.ai (the document declares no server; this is the origin it was published from)
URL
https://api.verdun.ai/scheduling/shift-blocks
Auth
HTTP bearer

Request body

group_idstring uuid required

The coverage group being scheduled.

shift_datestring date required

Center-local calendar date the shift STARTS on.

start_minuteinteger required

Minutes after local midnight of shift_date; multiple of 15.

end_minuteinteger required

Minutes after local midnight of shift_date; multiple of 15, greater than start_minute, and at most start_minute + 1440. Values above 1440 are the overnight case.

operator_idsstring[]

Seated operators in seat order - index 0 is the PRIMARY. May be empty to create an unassigned block.

notesstring nullable

Free-form notes about the shift.

colorstring nullable

Optional per-shift display color (hex). Null = inherit the coverage group's color.

Example request

{
  "shift_date": "2026-08-24",
  "start_minute": 1080,
  "end_minute": 1560,
  "color": "#4DFFD2"
}

Response

Successful Response

Example response

{
  "block": {
    "shift_date": "2026-08-24",
    "start_minute": 1080,
    "end_minute": 1560,
    "start_time": "18:00",
    "end_time": "02:00",
    "end_day_offset": 1,
    "color": "#4DFFD2"
  }
}

Changes

No recorded changes to this operation across all 2 revisions of this API.