Skip to main content
{
    "jobs":[
        {
            "assigneeName":"",
            "assigneeUsername":"",
            "carryOver":1,
            "contactEmail":"",
            "contactName":"",
            "contactPhone":"",
            "confirmationEmails":"",
            "customFields":[],
            "day":0,
            "destinationLat":37.7749,
            "destinationLng":122.4194,
            "destinationName":"This is a new job in San Francisco created via API",
            "destinationText":"",
            "dispatcherName":"",
            "dispatcherUid":"",
            "dispatcherUrl":"",
            "id":"64d88ed519c0ae41096aa4b4",
            "inputFormConfig":"",
            "itemsToDropoff":0,
            "itemsToPickup":0,
            "label":"",
            "linkedForms":"",
            "linkedZones":"",
            "manualChecks":"",
            "number":0,
            "onSiteSeconds":720,
            "orderId":0,
            "placeName":"",
            "placeUid":"",
            "placeUrl":"",
            "priority":5,
            "radius":100,
            "receiverUid":"",
            "scheduledEnd":0,
            "scheduledStart":0,
            "signatureName":"",
            "signaturePdf":"",
            "signatureSvg":"",
            "teamId":0,
            "textDispatcher":"",
            "textReceiver":"",
            "tsAccepted":0,
            "tsAssigned":0,
            "tsCheckIn":0,
            "tsCheckNFC1":0,
            "tsCheckNFC2":0,
            "tsCheckOut":0,
            "tsCreated":1691913941055,
            "tsDoneFailed":0,
            "tsDoneSuccess":0,
            "tsRejected":0,
            "tsSaved":1691913941055,
            "tsScheduled":0,
            "tsSignature":0,
            "type":0,
            "windowEnd":2400,
            "windowStart":0,
            "worker":"",
            "workerName":""
        }
    ],
    "status":0
}

​
REQUEST

POST https://api.hellotracks.com/api/editjobs

{
	data: {
		jobs: {
			"<job_id_1>" : {
				"<attr_1>" : value,
				   ...
				"<attr_n>" : value,
			},
			"<job_id_2>" : job_2,
			   ...
			"<job_id_n>" : job_n
		},
		notify: boolean,
		sendRouteChange: boolean (optional)
	}
}
Compare Job API Object to see all modifiable attributes (all which are marked as RW). You are not able to change the id of a job, but most job properties are modifiable. Special Attributes:
  • Use worker field with a username to assign/reassign a job
  • Use receiverUid field with a UID to assign/reassign a job
  • Set receiverUid to empty string "" to unassign a job
  • Job templates can be edited using the tpl- prefix in the job ID

​
Body

​
jobs
object
required
Object, set field name to the id of the job to edit. The value is an obect with one or multiple fields. Follow the schema of the Job API object for the value object.
​
notify
boolean
default:true
Set notify:true if you want to generate a notification in case the progress status of this job changed (e.g., job completion, rejection, check-in/out). To omit creating notifications for this job modification, set notify:false. The notify attribute is optional and defaults to true.
​
sendRouteChange
boolean
default:false
If true and the job is assigned with day set to today, notifies the assignee immediately of the route change. The list of jobs will be updated automatically on their device.
Permissions: Workers can only edit jobs for today unless the workers_edit_job setting is enabled. Changes to the day field by workers require this permission.
{
    "jobs":[
        {
            "assigneeName":"",
            "assigneeUsername":"",
            "carryOver":1,
            "contactEmail":"",
            "contactName":"",
            "contactPhone":"",
            "confirmationEmails":"",
            "customFields":[],
            "day":0,
            "destinationLat":37.7749,
            "destinationLng":122.4194,
            "destinationName":"This is a new job in San Francisco created via API",
            "destinationText":"",
            "dispatcherName":"",
            "dispatcherUid":"",
            "dispatcherUrl":"",
            "id":"64d88ed519c0ae41096aa4b4",
            "inputFormConfig":"",
            "itemsToDropoff":0,
            "itemsToPickup":0,
            "label":"",
            "linkedForms":"",
            "linkedZones":"",
            "manualChecks":"",
            "number":0,
            "onSiteSeconds":720,
            "orderId":0,
            "placeName":"",
            "placeUid":"",
            "placeUrl":"",
            "priority":5,
            "radius":100,
            "receiverUid":"",
            "scheduledEnd":0,
            "scheduledStart":0,
            "signatureName":"",
            "signaturePdf":"",
            "signatureSvg":"",
            "teamId":0,
            "textDispatcher":"",
            "textReceiver":"",
            "tsAccepted":0,
            "tsAssigned":0,
            "tsCheckIn":0,
            "tsCheckNFC1":0,
            "tsCheckNFC2":0,
            "tsCheckOut":0,
            "tsCreated":1691913941055,
            "tsDoneFailed":0,
            "tsDoneSuccess":0,
            "tsRejected":0,
            "tsSaved":1691913941055,
            "tsScheduled":0,
            "tsSignature":0,
            "type":0,
            "windowEnd":2400,
            "windowStart":0,
            "worker":"",
            "workerName":""
        }
    ],
    "status":0
}