Manage work order scheduling and ETAs.
Manage the when and timing of work orders.
PUT /workorders/{id}/schedule
Provider must arrive at a specific time:
{
"service_window": {
"mode": "exact",
"start": { "utc": "2024-01-15 09:00:00" }
}
}Provider can arrive anytime within a window:
{
"service_window": {
"mode": "between",
"start": { "utc": "2024-01-15 09:00:00" },
"end": { "utc": "2024-01-15 17:00:00" }
}
}| Mode | Description |
|---|---|
exact | Must arrive at specific time |
between | Arrival window (e.g., 9am-5pm) |
asap | As soon as possible |
Providers signal their expected arrival time:
POST /workorders/{id}/eta
{
"eta": { "utc": "2024-01-15 09:30:00" },
"notes": "Traffic is light, arriving early"
}GET /workorders/{id}/schedule
{
"service_window": {
"mode": "between",
"start": { "utc": "2024-01-15 09:00:00" },
"end": { "utc": "2024-01-15 17:00:00" }
},
"provider_eta": {
"utc": "2024-01-15 10:00:00"
},
"time_zone": "America/Chicago"
}All times are in UTC. Convert to local time zone for display using the time_zone field.
Last updated on