Skip to main content
This rule allows you to enforce minimum rest periods between different types of work. It works by defining what triggers a cooldown (starts) and what should be avoided during that cooldown period (ends). This is useful for ensuring employees have adequate rest between demanding shifts, preventing burnout, and complying with labor regulations.

Rule schema

​
cooldownRule
object
Used to define required or desired rest between working shifts.

​
Basic cooldown between shifts

The simplest use case is to require a minimum rest period between any two shifts. This ensures employees have adequate time to recover between work periods. When you omit the starts and ends sections, the rule applies to all shifts.
The rule below requires a minimum of 12 hours of rest between any two shifts. After an employee finishes any shift, they cannot start another shift until at least 12 hours have passed.
{
  "id": "cd-min-12h-rest",
  "importance": "STRICT",
  "targets": {
    "minHours": 12
  }
}

​
Cooldown between specific shift types

You can define cooldowns that only apply between specific types of shifts. For example, you might want a longer cooldown after night shifts before morning shifts.
The rule below requires at least 16 hours of rest after a night shift before an employee can work a morning shift. This helps ensure employees have adequate time to adjust their sleep schedule.
{
  "id": "cd-night-to-morning",
  "importance": "STRICT",
  "targets": {
    "minHours": 16
  },
  "starts": {
    "shifts": {
      "labels": ["night"]
    }
  },
  "ends": {
    "shifts": {
      "labels": ["morning"]
    }
  }
}

​
Cooldown measured in days

Instead of specifying the cooldown in hours, you can specify it in days. This is useful for ensuring employees have full days off between certain types of work.
The rule below requires at least 2 days without a shift after working a weekend shift before an employee can work another weekend shift. This helps distribute weekend work more evenly among employees.
{
  "id": "cd-weekend-2-days",
  "importance": "STRICT",
  "targets": {
    "minDays": 2
  },
  "starts": {
    "shifts": {
      "labels": ["weekend"]
    }
  },
  "ends": {
    "shifts": {
      "labels": ["weekend"]
    }
  }
}

​
Complex cooldown scenarios

You can create more complex cooldown rules by combining different shift types in the starts and ends sections. This allows you to model sophisticated rest requirements.
The rule below requires at least 48 hours of rest after working any intensive shift (like emergency shifts or long shifts) before an employee can work another intensive shift. This helps prevent employee burnout from demanding work.
{
  "id": "cd-intensive-48h",
  "importance": "STRICT",
  "targets": {
    "minHours": 48
  },
  "starts": {
    "shifts": {
      "labels": ["intensive"]
    }
  },
  "ends": {
    "shifts": {
      "labels": ["intensive"]
    }
  }
}

​
Soft cooldown rules

While cooldown rules are often used with STRICT importance to enforce mandatory rest periods, you can also use them with other importance levels to encourage, but not strictly require, rest periods.
The rule below encourages, but doesn’t strictly require, at least 10 hours of rest after a night shift before an employee can work a morning shift. The solver will try to achieve this, but may violate it if necessary to satisfy other rules.
{
  "id": "cd-soft-night-to-morning",
  "importance": "MEDIUM",
  "targets": {
    "minHours": 10
  },
  "starts": {
    "shifts": {
      "labels": ["night"]
    }
  },
  "ends": {
    "shifts": {
      "labels": ["morning"]
    }
  }
}

​
Cooldown with specific shift IDs

You can also target specific shifts by their IDs, giving you fine-grained control over which shifts trigger cooldowns and which shifts are restricted during cooldown periods.
The rule below requires at least 8 hours of rest after a specific early morning shift (shift-1) before an employee can work a specific evening shift (shift-2). This is useful when you have specific shift pairs that should not be scheduled too close together.
{
  "id": "cd-specific-shifts",
  "importance": "STRICT",
  "targets": {
    "minHours": 8
  },
  "starts": {
    "shifts": {
      "ids": ["shift-1"]
    }
  },
  "ends": {
    "shifts": {
      "ids": ["shift-2"]
    }
  }
}

​
Cooldown with filters

You can also limit a cooldown rule to apply only to work carried out in specific roles.
The rule below requires a minimum of 16 hours of rest between any two shifts worked in role role-1. Shifts worked in other roles are not considered by this rule.
{
  "id": "cd-min-16h-rest-role-1",
  "importance": "STRICT",
  "filters": {
    "work": {
      "roles": {
        "ids": ["role-1"]
      }
    }
  },
  "targets": {
    "minHours": 16
  }
}