---
title: "Update Work order Scheduled Date"
method: PUT
path: "/workorders/{workorderId}/scheduledate"
tags: ["WorkOrders"]
---

# Update Work order Scheduled Date

`PUT /workorders/{workorderId}/scheduledate`

## Request

- Base URL: `https://sb2api.servicechannel.com/v3`
- URL: `https://sb2api.servicechannel.com/v3/workorders/{workorderId}/scheduledate`
- 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/scheduledate/put.ts> (a function with typed inputs; its response is checked against the schema)

Updates Work Order Scheduled Date. Returns Work order Id for successful request.
            <br /><br />Available for provider and subscriber usage.
            This method can only be used for users with 'WorkOrderScheduledDateChange' permissions.

## Path parameters

- `workorderId` integer, required

## Query parameters

- `rescheduleReasonCode` integer

## Request body

- ServiceChannelServicesMessagingWorkordersChangeWoFieldsRequest: Request to update the value of a work order parameter.
  - `Value` string, required: Value of the work order parameter to update.
  - `Actor` string: Name of the person on whose behalf you are updating the parameter value.

## 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/> 100 - You don't have location access to perform this operation; <br/> 502 - Data not found. Returned if target Work order is not found database; <br/> 503 - Request data is empty; <br/> 908 - Invalid Work order scheduled date specified. Returned if invalid date format was specified, scheduled date is smaller then Work order CallDate or bigger then Work order ExpirationDate; <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;
- `500`: Indicates that a generic error has occurred on the server.

---

[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)