---
title: "Reassign Work Order"
method: PUT
path: "/workorders/{workorderId}/reassign"
tags: ["WorkOrders"]
---

# Reassign Work Order

`PUT /workorders/{workorderId}/reassign`

## Request

- Base URL: `https://sb2api.servicechannel.com/v3`
- URL: `https://sb2api.servicechannel.com/v3/workorders/{workorderId}/reassign`
- Auth: OAuth 2
  - Authorization code: `https://sb2login.servicechannel.com/oauth/authorize`
  - Token URL: `https://sb2login.servicechannel.com/oauth/token`
- TypeScript: <https://skmtc.dev/servicechannel/apis/servicechannel-api-v-3/docs/workorders/:workorderId/reassign/put.ts> (a function with typed inputs; its response is checked against the schema)

Reassign Work Order to another provider. Returns Work order Id for successful request.
            <br /><br />Available for provider and subscriber usage.

## Path parameters

- `workorderId` integer, required

## Request body

- ServiceChannelServicesWebApiModelsRequestWorkOrderReassignWorkOrderReassignWorkOrderRequest: Reassign WorkOrder To other Provider
  - `WorkorderId` integer: Work order id.
  - `Trade` string: Trade
  - `Problem` string: Problem Description.
  - `ProblemCode` string: Problem Code.
  - `CurrencyId` integer: Optional, by default current Work Order Currency
  - `Nte` number, double: Optional Nte value, by default current Work Order NTE
  - `GlCode` string: Optional GL code value
  - `ReasonId` integer, required: Required, Reassignment reason Id.
  - `ProviderId` integer, required: Required, Provider id to assign.
  - `Category` string: Category.
  - `Priority` string: Priority
  - `Note` string: Note
  - `ProcessName` string: ProcessName
  - `RequestEmail` string: Request email
  - `RequestEmailCopy` string: Request email copy to
  - `NotifyProvider` boolean: Notify Provider: send email if true
  - `AdditionalApprovalCodes` ServiceChannelServicesWebApiModelsRequestWorkOrderReassignWorkOrderAdditionalApprovalCodeRequest[]: Additional approval codes
    - `Value` string
    - `Options` ServiceChannelServicesWebApiModelsRequestWorkOrderReassignWorkOrderAdditionalApprovalCodeOptionRequest[]
      - `Id` integer
      - `Value` string
    - `Header` string
    - `SetupId` integer
    - `LocationId` integer
    - `DefaultOptionId` integer
    - `ValueFormat` integer
    - `EditableAtLineItemLevel` integer
  - `ScheduledDate` string, date-time: Work order scheduled date
  - `OriginalETA` string, date-time: Original ETA
  - `RefreshApprovalCodes` boolean: If true: update Approval Codes
  - `RecallWorkOrderId` integer: Original work order Id
  - `LocationId` integer: WO location id
  - `PurchaseOrder` string: Purchase Order
  - `ApiRequest` boolean: API request
  - `Actor` string: Optional, Actor
  - `LabelId` integer
  - `Label` string
  - `DeleteLabel` boolean
  - `CategoryId` integer
  - `LabelIds` integer[]

## Response `200`

Indicates that the request succeeded and that the requested information is in the response.

- ServiceChannelServicesMessagingWorkordersChangeWorkOrderResponse: Object containing the details of the modified work order.
  - `id` integer: Unique work order identifier.

## Other responses

- `400`: Bad Request - the request could not be understood or was missing required parameters. <br/>Error codes: <br/> 1301 - Request data is empty; <br/> 101 - Invalid Provider Id; <br/>Provider not found for selected trade and location; <br/> 503 - Invalid Work order reassignment reason; <br/>Request data is empty; <br/>Required provider id not found;<br>Work order could not be reassigned. Only 'OPEN' and 'IN PROGRESS' statuses allowed; <br/>Provider or trade should be changed; <br/>Reassignment is blocked for work orders containing parts or materials; <br/> 905 - Invalid 'Nte' value; <br/>Nte value exceeds user limit; <br/> 921 - Cannot update invoiced Work order;
- `401`: Indicates that the requested resource requires authentication. <br/>Error codes: <br/> 504 - API call rejected by security permissions;
- `403`: Indicates that the server refuses to fulfill the request. <br/> Error codes: <br/> 804 - API call rejected by lack of provider permissions;

---

[API](https://skmtc.dev/servicechannel/apis/servicechannel-api-v-3.md) - [All operations](https://skmtc.dev/servicechannel/apis/servicechannel-api-v-3/llms.txt) - [OpenAPI document](https://skmtc.dev/servicechannel/apis/servicechannel-api-v-3/revisions/d490d6596809?raw)