---
title: "Removes link between two Work Orders"
method: PUT
path: "/workorders/{workorderId}/unlink"
tags: ["WorkOrders"]
---

# Removes link between two Work Orders

`PUT /workorders/{workorderId}/unlink`

## Request

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

Current Work Order is parent, followUp Work Order is linked Work Order If you set 'linkedWorkorderId' parameter then 'WorkorderIds' parameter of requested body will be ignored.  
  
Available for provider and subscriber usage.

## Path parameters

- `workorderId` integer, required

## Query parameters

- `linkedWorkorderId` integer

## Request body

- ServiceChannelServicesMessagingWorkordersUnlinkWorkordersRequest: Unlink Workorders Request
  - `WorkorderIds` integer[]: Array of Workorder Ids to Unlink, Required if 'UnlinkAllLinkedWorkorders' is false Ignored if 'UnlinkAllLinkedWorkorders' is true
  - `UnlinkAllLinkedWorkorders` boolean: Unlink all linked Workorders if true, Optional

## Response `204`

Indicates that the request succeeded

## Other responses

- `400`: Bad Request - the request could not be understood or was missing required parameters.<br/>Error codes:<br/> 917 - Wrong Parent Work Order Id;<br> 932 - Wrong Linked Work Order Id
- `401`: Indicates that the requested resource requires authentication.<br>Error codes:<br> 504 - API call rejected by security 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)