Sign in
Change Order

Update a change order. A full replacement of the header: omitted fields are cleared, except `notificationsEnabled`, where null keeps the stored value. The change order's impacted records and tasks are never written here — both are maintained elsewhere, and a concurrent change to either stands.

put/api/change-orders/{id}

Path parameters

idstring required

Request body

requestedUtcstring date-time nullable

When the change was requested (UTC). Defaults to the moment of creation when not supplied

dueDateUtcstring date-time nullable

When the change order is due (UTC)

approvedUtcstring date-time nullable

When the change order was approved (UTC)

completedUtcstring date-time nullable

When the change order was completed (UTC). Stamped server-side when status is Completed and none is supplied

status'new' | 'inProgress' | 'completed'

Where a change order stands.

detailstring nullable

What the change is

notificationsEnabledboolean nullable

Whether completing a task on this change order tells the owners of the next step. Null on a create takes the company default; null on an update keeps what the change order carries

Response

The updated change order

idstring nullable

The id of the change order

numberinteger

The change order's sequential number, unique within the tenant and assigned server-side

requestedUtcstring date-time nullable

When the change was requested (UTC). Defaults to the moment of creation when not supplied

dueDateUtcstring date-time nullable

When the change order is due (UTC), or null when it carries no date

approvedUtcstring date-time nullable

When the change order was approved (UTC), or null when it has not been

completedUtcstring date-time nullable

When the change order was completed (UTC). Stamped server-side when status moves to Completed without one supplied

status'new' | 'inProgress' | 'completed'

Where a change order stands.

detailstring nullable

What the change is

notificationsEnabledboolean nullable

Whether completing a task on this change order tells the owners of the next step

createdUtcstring date-time nullable

When the change order was created (UTC). Read-only

modifiedUtcstring date-time nullable

When the change order was last modified (UTC); supports incremental sync. Read-only

Changes