A job is essentially any background work that Xola is doing for a particular seller. The /api/jobs endpoints will allow you to fetch all the jobs for this seller and check on their status.
A job is created when there is any change done that requires extensive processing which cannot be completed in the lifecycle of an HTTP request. For example, when a seller modifies a schedule it has the potential to affect one or more trips & the dashboard too, therefore Xola will create a job to check and update availability for all affected trips.
Status
The following statuses are available for a job:
| Status | Meaning |
|---|---|
| new | The job was added to the queue but has not been picked up by a worker. |
| processing | The job is being processed right now. |
| completed | The job has finished processing and any necessary changes have been made. |
| error | The job failed & error'ed out. |
| stale | The job has been running too long and has timed out. It may or may not have finished all necessary tasks. This should rarely happen. |