← All resources

Resource

shift_definition

A reusable shift template — a start/end clock time and the weekdays it recurs on. Tenant-scoped; work centers reference it via their shift profiles rather than restating times.

GraphQL reference →

Configuration

nameString!Required

Human-readable label for the shift. Must not be blank.

startTimeString!Required

Local clock time the shift starts, as 24-hour "HH:mm".

endTimeString!Required

Local clock time the shift ends, as 24-hour "HH:mm". Earlier than startTime marks the shift as overnight.

activeDays[Int!]!Required

ISO-8601 weekdays the shift runs on (1 = Monday … 7 = Sunday). At least one required.

Read-only values

Show values
idShiftDefinitionID!Read only

TypeID of this shift definition (prefix "shd", e.g. "shd_01K…").

computed by the platform

isOvernightBoolean!Read only

Derived: true when endTime is earlier than startTime, i.e. the shift spans midnight.

computed by the platform

createdAtISO8601!Read only

ISO-8601 timestamp of when this shift definition was first persisted.

computed by the platform

updatedAtISO8601!Read only

ISO-8601 timestamp of the last successful write to this shift definition; equal to createdAt until it is first updated.

computed by the platform

Lifecycle

The CLI can create this resource. The platform assigns its id.

When replacement is needed, the existing resource is removed before its replacement is created.