Input schema (JSON)
{
"type": "object",
"properties": {
"demands": {
"type": "array",
"items": {
"type": "object",
"properties": {
"day": {
"type": "string",
"format": "date",
"description": "Shift date in YYYY-MM-DD format."
},
"end": {
"type": "string",
"pattern": "^\\d{2}:\\d{2}$",
"description": "Local shift end time in 24-hour HH:MM format."
},
"role": {
"type": "string",
"description": "Role required for this shift; defaults to Associate."
},
"shift": {
"type": "string",
"description": "Optional short shift label."
},
"start": {
"type": "string",
"pattern": "^\\d{2}:\\d{2}$",
"description": "Local shift start time in 24-hour HH:MM format."
},
"required": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Exact headcount when min_required and max_required are omitted."
},
"max_required": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Maximum headcount to assign to this shift."
},
"min_required": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Minimum headcount needed for this shift."
}
},
"additionalProperties": false
},
"maxItems": 1000,
"description": "Optional explicit fictional shift requirements. Each row can include day, role, start, end, shift, and required or min_required/max_required headcount. Omit to use sample shifts."
},
"industry": {
"enum": [
"auto-repair",
"clinic",
"restaurant",
"retail",
"warehouse"
],
"type": "string",
"default": "restaurant",
"description": "Business type used to select the fictional sample team and shift templates."
},
"team_size": {
"type": "integer",
"maximum": 12,
"minimum": 4,
"description": "Number of synthetic workers, from 4 to 12; defaults to the selected industry's sample size."
},
"period_mode": {
"enum": [
"week",
"month"
],
"type": "string",
"default": "week",
"description": "Schedule length: week or month. Defaults to one week."
},
"period_start": {
"type": "string",
"description": "Optional date in YYYY-MM-DD format inside the requested week or month; otherwise the next full period is selected."
},
"manager_request": {
"type": "string",
"maxLength": 4000,
"description": "Optional natural-language scheduling instructions for this fictional team only. Ambiguous requests stop for review; never include real staff or business data."
},
"coverage_per_shift": {
"type": "integer",
"default": 1,
"maximum": 3,
"minimum": 1,
"description": "Workers required on each enabled shift for each operating day."
},
"time_limit_seconds": {
"type": "number",
"default": 2,
"maximum": 10,
"minimum": 0.1,
"description": "Solver time budget, from 0.1 to 10 seconds. Defaults to 2 seconds."
},
"operating_days_per_week": {
"type": "integer",
"default": 7,
"maximum": 7,
"minimum": 1,
"description": "Number of open days, starting Monday. For example, 5 means Monday through Friday."
}
},
"additionalProperties": false
}