---
title: "Accept a work order"
method: PUT
path: "/workorders/{workOrderId}/accept"
tags: ["WorkOrders"]
---

# Accept a work order

`PUT /workorders/{workOrderId}/accept`

## Request

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

Allows a provider to accept a work order with an optional note.
            <br />When a work order is successfully accepted, it changes its status from *Open* to *In Progress / Dispatch Confirmed*. 
            <br />***Note***: Providers only can use this method.

## Path parameters

- `workOrderId` integer, required

## Request body

- ServiceChannelServicesMessagingWorkordersAcceptWorkOrderRequest: Request model to add a note to the work order while accepting it.
  - `Note` string: *Optional*. Note text.

## Response `200`

Work order is successfully accepted.

## Other responses

- `400`: The request was not accepted due to bad syntax, missing parameters, insufficient data, etc. <br/>Error codes: 502 &mdash; Work order is not found 804 &mdash; User has no permission to perform this action 904 &mdash; Work order is in status that does not allow to perform this action 5202 &mdash; This work order was already accepted 5203 &mdash; Acceptance of the work order failed
- `401`: The requested resource requires authentication. <br/>Error codes: 504 &mdash; API call rejected by security permissions
- `404`: Invalid work order ID.
- `500`: Something went wrong, and the server was unable to complete your request.

---

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