---
title: "Decline a work order on behalf of a technician"
method: PUT
path: "/ctools/workorder/{workOrderId}/decline"
tags: ["Ctools"]
---

# Decline a work order on behalf of a technician

`PUT /ctools/workorder/{workOrderId}/decline`

## Request

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

Declines a work order on behalf of the specified technician. Only Field Tech Manager (FTM) technicians can decline work orders.
            <br />If additional technician permissions are enabled for your company — “Technician”, “Supervising Tech”, and “Regional Manager” — the work order declined by a technician is automatically assigned to a Supervising Tech or Regional Manager or forwarded to the next ranked provider based on the configured auto-assignment rules. If these permissions are not enabled, the work order is either forwarded to the next ranked provider or moved to the *Open/Declined* status, depending on the setup. Learn more about [automating work order assignments and setting up forwarding rules](https://servicechannel.atlassian.net/wiki/spaces/SCU/pages/640582807/Automating+Work+Order+Assignments+and+Forwarding+Work+Orders) in ServiceChannel University.
            <br />***Note:*** This method is only available to provider admins.

## Path parameters

- `workOrderId` integer, required

## Query parameters

- `userId` integer, required

## Response `201`

The work order is successfully declined by the specified technician. The response is intentionally blank.

## Other responses

- `400`: The request is not accepted due to bad syntax, missing parameters, insufficient data, etc.
- `401`: The request is not authorized.
- `500`: The server was unable to complete the request due to an internal error.

---

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