curl -X POST https://api.hellotracks.com/api/assignjob \
--header 'API-Key: YOUR_KEY_ID.YOUR_SECRET' \
--header 'Content-Type: application/json' \
-d '{ "data": { "id": "650000000000000000000001", "assignee": "a1b2c3", "day": 20261102, "index": 0, "notify": true, "push": true } }'
Dispatch and Routing
Assign Job
Move a job into a worker’s route on a day, at a position.
POST
/
api
/
assignjob
curl -X POST https://api.hellotracks.com/api/assignjob \
--header 'API-Key: YOUR_KEY_ID.YOUR_SECRET' \
--header 'Content-Type: application/json' \
-d '{ "data": { "id": "650000000000000000000001", "assignee": "a1b2c3", "day": 20261102, "index": 0, "notify": true, "push": true } }'
Puts one job into a worker’s route on a day, at the position you choose. Use it to dispatch: unlike changing the worker with Edit Jobs, it keeps both routes in order. The job leaves the previous worker’s route, which closes the gap, and the jobs after it in the new route move down by one. The saved route of both days is recalculated.
REQUEST
POST https://api.hellotracks.com/api/assignjob
{
data: {
id: "<job_id>",
assignee: "<member_uid>",
day: 20261102,
index: 2,
notify: true,
push: true,
webhook: true
}
}
string
required
The job to move.
string
required
UID of the member who gets the job. An empty string takes the job off any worker.
number
default:0
The day as YYYYMMDD.
0 leaves the job without a date; it is then not part of a route.number
default:0
Position in the worker’s route on that day, starting at
0 for the first job. A position after the last job puts it at the end.boolean
default:false
Update open dashboards right away.
boolean
default:false
Update the jobs in both workers’ apps.
boolean
default:false
Send the company’s
job_updated webhooks for every job that changed.RESPONSE
{
status: 0,
jobs: [
{ <job_1> },
{ <job_2> },
...
]
}
jobs lists the moved job and every job of both routes, with their new positions. An unknown job id changes nothing and returns an empty list.
curl -X POST https://api.hellotracks.com/api/assignjob \
--header 'API-Key: YOUR_KEY_ID.YOUR_SECRET' \
--header 'Content-Type: application/json' \
-d '{ "data": { "id": "650000000000000000000001", "assignee": "a1b2c3", "day": 20261102, "index": 0, "notify": true, "push": true } }'