Provider Actions

Providers may need to cancel or report delays. These endpoints handle those lifecycle exceptions.

Provider Cancel

A provider can request to be removed from a work order.

POST /workorders/{id}/provider/cancel

{
  "reason": "Vehicle breakdown",
  "reason_id": 5,
  "note": "Cannot make it to site today"
}

This will:

1. Remove the provider assignment
2. Change work order status back to Routed (or Published)
3. Log the cancellation reason

Provider Delay

A provider can signal they will be late.

POST /workorders/{id}/provider/delay

{
  "delay_minutes": 30,
  "reason": "Traffic accident ahead",
  "new_eta": { "utc": "2024-01-15 10:30:00" }
}

Get Routed Providers

List all providers who have currently been routed the work order (visible to them).

GET /workorders/{id}/providers

{
  "results": [
    {
      "id": 12345,
      "first_name": "John",
      "last_name": "Doe",
      "status": "requesting"
    },
    {
      "id": 67890,
      "first_name": "Jane",
      "last_name": "Smith",
      "status": "routed"
    }
  ]
}

Related

• Assignments - Managing assignments
• Schedule - Updating ETAs
• Revisits - Rescheduling work