# POST /work-orders/send-work-status

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

Send a PIN-protected Work Status Portal link to a client via email. The client receives a unique link where they can view the progress of all work orders on the deal. Requires the deal to have work orders and the company to have email configured. Returns success, portal_id, and token.

## Parameters

| Name | In | Type | Required | Description |
|------|----|------|----------|-------------|
| `deal_id` | body | uuid | yes | Deal UUID. The portal shows all work orders for this deal. |
| `recipient_email` | body | string | yes | Client email address |
| `recipient_name` | body | string | yes | Client display name |
| `personal_message` | body | string | no | Optional personal message included in the email |
| `expires_in_days` | body | number | no | Days until the portal link expires (default 30) |

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