# PATCH /work-orders/:work_order_id

**Resource:** [Work Orders](./work-orders.md)  
**MCP tool:** `update_work_order`  
**Scopes:** `work-orders:write`  
**Write operation:** yes

Update a work order (status, schedule, data fields, and/or its assignee crew). Pass assignee_ids (array of user UUIDs) to replace the crew; the first becomes the primary assignee.

## Parameters

| Name | In | Type | Required | Description |
|------|----|------|----------|-------------|
| `work_order_id` | path | string | yes |  |
| `status_id` | body | string | no |  |
| `status` | body | string | no |  |
| `data` | body | object | no |  |
| `schedule_date` | body | string | no |  |
| `schedule_time` | body | string | no |  |
| `assignee_ids` | body | array | no | User UUIDs for the crew; replaces the current assignees. First is kept as the primary. |
| `notes` | body | string | no |  |
| `fields` | body | object | no |  |

## Request example

```bash
curl -X PATCH   "https://api.trustpager.com/functions/v1/api/v1/work-orders/:work_order_id"   -H "Authorization: Bearer YOUR_API_KEY"   -H "Content-Type: application/json"   -d '{"status_id":"...","notes":"...","fields":"..."}'
```

---
Base URL: `https://api.trustpager.com/functions/v1/api/v1` — Auth: `Authorization: Bearer YOUR_API_KEY`