---
title: "Update a work request"
method: PUT
path: "/workrequests/{workRequestId}"
tags: ["WorkRequests"]
---

# Update a work request

`PUT /workrequests/{workRequestId}`

## Request

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

*In limited availability phase.*

## Path parameters

- `workRequestId` integer, required

## Request body

- ServiceChannelServicesMessagingWorkRequestsUpdateWorkRequestRequest: Request to update a work request properties
  - `StatusId` integer: Status Id
  - `ExtendedStatusId` integer: Extended Status Id
  - `ClosedReasonId` integer: Closed Reason Id
  - `WorkOrderId` integer: Work Order Id
  - `PriorityId` integer: Priority Id
  - `CategoryId` integer: Category Id
  - `ScheduledDate` string: Scheduled date
  - `Description` string: Description
  - `TradeId` integer: Trade Id
  - `NTE` number, double: NTE value

## Response `200`

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

## Other responses

- `400`: Bad Request - the request could not be understood or was missing required parameters. <br/>Error codes: 301 - Contract not found for specified subscribers location, provider and trade 502 - WorkRequest not found 701 - Invalid trade 8006 - ScheduledDate has wrong format 8007 - Invalid status 8008 - Invalid extended status 8009 - Invalid category 8010 - Invalid priority 8011 - Invalid currency 8019 - ScheduledDate must be greater than CallDate 8107 - Work request is closed 8108 - Closed reason is required for Closed status 8109 - Work order id is required for this closed reason 8110 - Invalid closed reason 8111 - Closed reason could be set only for Closed status 8112 - Invalid work order id 8113 - Work order id could be set only for Closed status 8114 - Work order id could be set only for &apos;Work order created&apos; reason
- `401`: The request is not authorized. <br/>Error codes: 504 — API call rejected by security permissions
- `500`: Indicates that a generic error has occurred on the server. <br/>Error codes: 501 - Internal Error code

---

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