Update a Work Order Status

less than 1 minute read

For further work order processing, for example, to create an invoice, you may need to change a work order status.

To update a work order status, send the following request:

PUT /workorders/{workorderId}/status

Header Value
Content-Type application/json
Parameter Parameter type Example value
workorderId Path 88472932
updateRequest Body See below

updateRequest object

Element Data type Required Note
Status.Primary String Required You can use a status Id instead of a full status name, for example, "Primary": "3".
Status.Extended String Optional  
Note String Optional Your note describing why you’re changing the work order status.

Example request:

PUT https://sb2api.servicechannel.com/v3/workorders/88472932/status HTTP/1.1
Authorization: Bearer {access_token}
Content-Type: application/json

{
  "Status": {
    "Primary": "COMPLETED",
    "Extended": "PENDING CONFIRMATION"
  },
  "Note": "WO completed, waiting for confirmation."
}

Example response:

{
  "result": "Status has been changed from '<b>OPEN</b>' to '<b>COMPLETED / PENDING CONFIRMATION</b>' with the following comment 'WO completed, waiting for confirmation.'",
  "id": 88472932
}

Response code: HTTP/1.1 200 OK

Important: Providers are usually not allowed to change a work order status to billable. By default, there are two billable statuses: COMPLETED and COMPLETED/CONFIRMED. See About Work Order Life Cycle and Statuses to learn more.

Updated: