WorkOrders

Decline a work order

Allows a provider to decline a work order with a note. When a provider declines a work order, the order changes its status from Open to Open / Declined or becomes automatically reassigned to another provider if the WOMultipleAutoReassign feature flag is turned on for the subscriber. Note: Providers only can use this method.

put/workorders/{workOrderId}/decline

Request

Base URL
https://sb2api.servicechannel.com/v3
Auth
OAuth 2
Authorization codehttps://sb2login.servicechannel.com/oauth/authorize
Token URLhttps://sb2login.servicechannel.com/oauth/token
TypeScript
https://skmtc.dev/servicechannel/apis/servicechannel-api-v-3/docs/workorders/:workOrderId/decline/put.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

workOrderIdinteger required

Unique numeric identifier of the work order.

Request body

DeclineReasonIdinteger

Unique numeric identifier of the work order decline reason. Possible values: 1 - Can't make ETA, 2 - Trade not serviced, 3 - Location not serviced, 4 - Not under warranty, 5 - Other, 6 - NTE too low. Note: The parameter is required when the DeclineHistoryWO feature flag is on.

CustomDeclineReasonstring

Text explaining the reason for the work order decline. Note: The parameter is required when the decline reason has AskCustomReason=true.

Notestring

Optional. Note text.

Response

Work order is declined.

Changes

No recorded changes to this operation across all 1 revision of this API.