---
title: "Delete work order by external ID"
method: DELETE
path: "/workorders/external/{externalId}"
tags: ["Work Orders"]
---

# Delete work order by external ID

`DELETE /workorders/external/{externalId}`

## Request

- Base URL: `https://api.getmaintainx.com/v1`
- URL: `https://api.getmaintainx.com/v1/workorders/external/{externalId}`
- Auth: HTTP bearer

## Path parameters

- `externalId` string, required

## Query parameters

- `skipWebhook` boolean

## Headers

- `x-organization-id` integer

## Response `204`

Successfully deleted the workOrder

## Other responses

- `400`: OrganizationId was not provided
- `401`: Invalid token
- `404`: Could not find the specified workOrder.
- `500`: Internal server error.

## Changes

> 30 revisions in range; 1 not diffed.

- **2026-09-14** `bf9ccb1af927`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/getmaintainx/apis/maintainx-api/changes/workorders/external/:externalId/delete.md)

---

[API](https://skmtc.dev/getmaintainx/apis/maintainx-api.md) - [All operations](https://skmtc.dev/getmaintainx/apis/maintainx-api/llms.txt) - [OpenAPI document](https://skmtc.dev/getmaintainx/apis/maintainx-api/revisions/6258367c04ff?raw)