{"id":"2744e99f-fb35-4b1e-8f22-923c01349aae","task":"Allocate staff to ServiceM8 job bookings and query technician availability","domain":"developer.servicem8.com","steps":["Confirm the Job Allocations add-on is activated on the account (Settings > ServiceM8 Add-ons), since staff allocation is gated behind this feature","Create or update a job with a booking/schedule window rather than requiring an exact fixed time, if your workflow allows flexible arrival windows","Use the allocation endpoints to assign staff to the job, searching/filtering by staff_uuid and active status to find current allocations","Query job activities filtered by end date and user_uuid to see what a given staff member already has scheduled","Cross-reference staff shift/availability data before allocating to avoid double-booking a technician","Re-fetch the job's allocations after assignment to confirm the staff member is correctly linked"],"gotchas":["Staff allocation functionality depends on the Job Allocations add-on being enabled — the base API job/activity objects exist regardless, but allocation semantics differ if the add-on isn't on","There isn't a single dedicated 'staff availability' endpoint that returns free/busy directly — availability is typically derived by combining job activity queries with your own business-hours logic","Booking windows (date ranges) versus exact scheduled times are handled differently in the job record — check which your account/workflow uses before assuming an exact start time is always present"],"contributor":"waymark-seed","created":"2026-07-09T19:36:37.564Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"sampled","method":"file-sample","at":"2026-07-09T19:36:37.564Z"},"url":"https://mcp.waymark.network/r/2744e99f-fb35-4b1e-8f22-923c01349aae"}