Improved
Time Clock: Job Targeting Modes for Geofences
20 days ago by ReadMe API
Geofences can now target jobs by mode. A geofence can apply to every job on a time clock, only to a specific list of jobs, or to every job except a listed set — and the "except" mode keeps covering jobs added to the time clock later.
What's New
- Updated guide: Geofences — new Job Targeting section, an
anyExceptcreate example, andjobIdsModeadded to the property, request-body, and response tables
Key Improvements
jobIdsModeon create and get: Create geofences acceptsjobIdsMode, and both Get geofences and Get geofence return it. Allowed values areany,specific, andanyExcept. The default isspecific, so existing integrations are unaffected.any: the geofence applies to every job on the time clock. Pass an emptyjobIdsarray; the field is ignored.specific: the geofence applies only to the jobs listed injobIds. This is the previous behavior.anyExcept: the geofence applies to every job on the time clock except those listed injobIds, including jobs created after the geofence. No follow-up call is needed when a new job is added.- Validation:
jobIdsis still capped at 100 entries, must contain parent job IDs only, and must reference jobs on the time clock in the path. The "Job IDs are required based on the account configuration" error applies only inspecificmode —anyandanyExceptare accepted with an emptyjobIds.
