Skip to main content

Convert to Work Order

Once a request is triaged, turn it into a dispatchable work order. You have two paths.

Path A: Convert as-is​

Uses the tenant's original report as the work order scope. Fastest, but tenant text is often not what a tradie needs:

"The thing in the kitchen keeps making that noise again and dad said it was probably the filter"

Good tradies figure it out, but you'll get more callbacks.

Path B: Draft scope with AI​

Claude reads the triaged request and writes a structured, tradie-facing scope:

Issue: intermittent rattling noise from dishwasher, recurring.
Access: tenant home after 4pm weekdays, all day Sat.
Scope:
  1. Inspect dishwasher pump assembly — likely cause of rattle.
  2. Replace water filter if clogged.
  3. Test through a full wash cycle.
  4. If pump requires replacement, provide quote before proceeding
     beyond the $450 cost ceiling.
Expected duration: 1–2 hours.
Cost ceiling: $450 (AI-suggested, override as needed).

Claude also returns a suggested cost ceiling based on category + scope. Editable before commit.

Cost ceiling and owner approval​

Every property has an owner_approval_threshold (default $500, editable per property). When the work order's cost ceiling is:

  • ≤ threshold → dispatched immediately
  • > threshold → moves to AWAITING_QUOTE, owner is notified, PM gets a chase task

This stops tradies from running up $2,000 bills without consent while still letting small jobs fly.

API​

POST /api/v1/work-orders/draft-scope
Content-Type: application/json

{
  "maintenanceRequestId": "MR-2189"
}

Returns:

{
  "scope": "Issue: intermittent rattling...",
  "suggestedCostCeilingCents": 45000,
  "modelVersion": "claude-haiku-4-5@prompt-v1"
}

Non-mutating — call as many times as you want. Nothing is written until you commit the WO.

POST /api/v1/maintenance-requests/{id}/convert-to-work-order
Content-Type: application/json

{
  "scope": "Issue: intermittent rattling...",
  "costCeilingCents": 45000
}

Creates the WorkOrder, transitions the request to ASSIGNED.

See also​