Response Structure
Top-Level Fields
Solution quality indicator. See Score.
List of employee-shift pairings. See Assignment.
Map of unassigned shift name to the list of hard constraints (e.g.
Employee Skill Match) that blocked assignment for that shift.Not currently populated by Fill. See ViolatedConstraint.
Not yet implemented for Fill. See Suggestion.
Score
The score indicates solution quality using a three-tier system.Score Interpretation
A negative soft score is normal and expected. The solver minimizes soft score violations while keeping hard constraints satisfied.
Assignment
Each assignment represents an employee assigned to a shift.Example Assignment List
ViolatedConstraint
violations is a field inherited from the shared response model, but Fill does not currently populate it — it is always absent on Fill responses. Use unassigned and unservedReasons on this response for per-shift blocking information, or call /v2/fill/jobs/{id}/explanation for detailed conflict data (conflicts, unresolved).
Suggestion
Alternative assignment options intended to be returned by the suggest API, using the same shape as Assignment.Weights Reference
Available constraint weights for customization in requests.Custom Weight Format
Override defaults using the format<weight><priority>: