Update a work order

Changes the status, priority, category, assignee or dates of a work order.

PATCH https://cotlet.dev/api/v1/resman/properties/{property_id}/work-orders/{work_order_id}

write Confirm

Returns the work order as saved. A status change is visible to the resident who reported it. ResMan accepts only an employee marked as a maintenance employee as the assignee and refuses any other. By default you confirm each call; you can switch that off for this tool.

Parameters

Parameters: update_work_order
NameTypeDescription
property_id string required string Property id from list_properties.
work_order_id string required string Work order id from list_work_orders.
status string string Submitted, Not Started, In Progress, Completed, Scheduled, Cancelled, Closed or On Hold.
priority string string Low, Medium or High.
category_id string string Category id from list_work_order_options.
assigned_to_person_id string string Person id of a maintenance employee.
scheduled_date string string When the work is scheduled, YYYY-MM-DD HH:MM in the property time.
notes string string Notes for the technician.

Request

cURL
curl -X PATCH https://cotlet.dev/api/v1/resman/properties/f308c33b-5865-4f7e-97af-46d35f19eddf/work-orders/a68ce6b2-a9ef-4127-bf97-067e9f4a548c \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"status":"Not Started","priority":"High","assigned_to_person_id":"b5efc29c-a706-4a95-a92f-7b1adcdd7c5c"}'
Python
result = client.call("resman", "update_work_order", {"property_id":"f308c33b-5865-4f7e-97af-46d35f19eddf","work_order_id":"a68ce6b2-a9ef-4127-bf97-067e9f4a548c","status":"Not Started","priority":"High","assigned_to_person_id":"b5efc29c-a706-4a95-a92f-7b1adcdd7c5c"})
Node.js
const result = await cotlet.call('resman', 'update_work_order', {"property_id":"f308c33b-5865-4f7e-97af-46d35f19eddf","work_order_id":"a68ce6b2-a9ef-4127-bf97-067e9f4a548c","status":"Not Started","priority":"High","assigned_to_person_id":"b5efc29c-a706-4a95-a92f-7b1adcdd7c5c"});
CLI
cotlet call resman update_work_order --data '{"property_id":"f308c33b-5865-4f7e-97af-46d35f19eddf","work_order_id":"a68ce6b2-a9ef-4127-bf97-067e9f4a548c","status":"Not Started","priority":"High","assigned_to_person_id":"b5efc29c-a706-4a95-a92f-7b1adcdd7c5c"}'

Example response

JSON

{
  "work_order_id": "a68ce6b2-a9ef-4127-bf97-067e9f4a548c",
  "property_id": "f308c33b-5865-4f7e-97af-46d35f19eddf",
  "status": "Not Started",
  "priority": "High",
  "assigned_to": "Robert Wilcox"
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.