/maintainx-work-orders | Type: Application | PCID required: Yes
Tools
maintainx_work_orders_create_workorders
Create new work order Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
skipWebhook | boolean | No | — | Set skipWebhook=true to skip all webhooks upon successful work order creation. |
x-organization-id | integer | No | — | Required if using a multi organizations token |
assetId | integer | No | — | Asset Id |
assignees | object[] | No | — | Either the teamId, the userId or the user email address |
categories | string[] | No | — | List of categories that identify the work order |
description | string | No | — | The description value |
dueDate | string | No | — | Date & time at which the work order is due |
estimatedTime | integer | No | — | The estimated time taken in seconds to complete the work order |
externalData | object | No | — | Extra data that can be attached to the work order, for example to help reference to a matching record in an external system. |
extraFields | object | No | — | Custom Fields on the entity. The object keys are the exact Custom Field labels, including spaces or special characters. (ie: “Estimated Time Allotted”) |
isParent | boolean | No | — | Whether the work order is a parent work order. A parent work order has only a subset of the standard work order fields. It also has fields that aren’t included in a standard work order. <a href=‘https://help.getmaintainx.com/multi-asset-work-orders?utm_source=mx-api-docs&utm_medium=web&utm_campaign=multi-asset-work-orders&utm_id=maintainx’ target=’_blank’>Learn more</a></br>Mutually exclusive with parentId |
locationId | integer | No | — | Global ID of the location assigned to the work order |
parentId | number | No | — | ID of the parent work order. If provided, the work order will be created as a sub-work order under this parent work order. Sub-work orders inherit most of their fields from the parent work order. <a href=‘https://help.getmaintainx.com/create-and-manage-sub-work-orders?utm_source=mx-api-docs&utm_medium=web&utm_campaign=create-and-manage-sub-work-orders&utm_id=maintainx’ target=’_blank’>Learn more</a></br>Mutually exclusive with isParent |
partsUsed | object[] | No | — | Parts IDs and quantities used in this work order |
priority | string | No | — | The priority value |
procedure | object | No | — | The procedure value |
procedureTemplateId | number | No | — | ID of the procedure template to attach |
repeatability | object | No | — | The repeatability value |
requesterId | object | No | — | ID or email of the user who requested the work order |
skipRestHook | boolean | No | — | When work order is created, will not trigger any rest hook that is subscribed |
startDate | string | No | — | Date & time at which the work order will show up in the inbox</br>Only valid when <b>dueDate</b> is set |
title | string | Yes | — | The title value |
type | string | No | — | Valid types of Work Orders. |
vendorIds | number[] | No | — | Vendor IDs |
workOrderTemplateId | integer | No | — | ID of the Work Order Template that will be used to create this work order. Note that data from the payload will overwrite the Template data. Also, restrictions defined by the Template (EG: Required/Hidden/Read-Only fields) will apply. |
workRequestId | integer | No | — | ID of the Work Request that will be approved by the creation of this work order |
maintainx_work_orders_create_workorders_comments
Create new comment on a work order Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | Global ID of the work order |
skipWebhook | boolean | No | — | Set skipWebhook=true, skipWebhook=1 or skipWebhook=yes to skip all webhooks upon successful operation on the endpoint. Learn more about webhooks |
content | string | Yes | — | Content of the comment to post |
maintainx_work_orders_create_workorders_costs
Create new cost on a work order Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | Global ID of the work order |
skipWebhook | boolean | No | — | Set skipWebhook=true, skipWebhook=1 or skipWebhook=yes to skip all webhooks upon successful operation on the endpoint. Learn more about webhooks |
body | object | Yes | — | Cost to create |
maintainx_work_orders_create_workorders_emails
Send work order as an email Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | Global ID of the work order |
skipWebhook | boolean | No | — | Set skipWebhook=true, skipWebhook=1 or skipWebhook=yes to skip all webhooks upon successful operation on the endpoint. Learn more about webhooks |
customMessage | string | No | — | Custom message to send with the Work Order |
emails | string[] | No | — | Emails to send the Work Order to |
exportOptions | object | No | — | Type of export options for the work order attached to the email |
maintainx_work_orders_create_workpermits_sign
Sign a work permit Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | ID of the id |
skipWebhook | boolean | No | — | Set skipWebhook=true, skipWebhook=1 or skipWebhook=yes to skip all webhooks upon successful operation on the endpoint. Learn more about webhooks |
externalLinkUuid | string | Yes | — | Global UUID of the External Link used to sign the Work Permit |
signerName | string | Yes | — | Name of the signer when using an External Link |
maintainx_work_orders_create_workrequestportals
Create new work request portal Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
skipWebhook | boolean | No | — | Set skipWebhook=true, skipWebhook=1 or skipWebhook=yes to skip all webhooks upon successful operation on the endpoint. Learn more about webhooks |
x-organization-id | integer | No | — | Required if using a multi organizations token |
assetId | integer | No | — | ID of the asset related to the portal |
contactInformation | string | No | — | Contact of the person creating the portal (email or phone number) |
descriptionPlaceholder | string | No | — | Placeholder text for the description field |
emailOnly | boolean | No | — | Allow request creation with email only to contact the requester |
locationId | integer | No | — | ID of the location where the portal is located |
sendEmailNotification | boolean | No | — | Send email notifications to the portal requesters with status updates on their requests |
title | string | Yes | — | Title of the portal |
welcomeText | string | No | — | Description text describing the portal |
maintainx_work_orders_create_workrequests
Create work request Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
skipWebhook | boolean | No | — | Set skipWebhook=true, skipWebhook=1 or skipWebhook=yes to skip all webhooks upon successful operation on the endpoint. Learn more about webhooks |
x-organization-id | integer | No | — | Required if using a multi organizations token |
approverTeamId | number | No | — | ID of the team that is reponsible for approving the request. |
assetId | number | No | — | Asset Id |
creatorContactInfo | string | No | — | The creator’s contact information associated with this work order request. Possible types are EMAIL, PHONE, and OTHER, which will be inferred from the string provided |
description | string | No | — | The description value |
extraFields | object | No | — | Custom Fields on the entity. The object keys are the exact Custom Field labels, including spaces or special characters. (ie: “Request Type”) |
locationId | number | No | — | Location Id |
priority | string | No | — | The priority value |
title | string | Yes | — | The title value |
maintainx_work_orders_delete_workorders
Delete workOrder Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | ID of the workOrder |
skipWebhook | boolean | No | — | Set skipWebhook=true, skipWebhook=1 or skipWebhook=yes to skip all webhooks upon successful operation on the endpoint. Learn more about webhooks |
maintainx_work_orders_delete_workorders_attachments
Remove work order attachment Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | ID of the work order. |
filename | string | Yes | — | Name of the attachment, including the extension. |
skipWebhook | boolean | No | — | Set skipWebhook=true, skipWebhook=1 or skipWebhook=yes to skip all webhooks upon successful operation on the endpoint. Learn more about webhooks |
maintainx_work_orders_delete_workorders_procedure
Detach procedure from work order Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | ID of the work order |
skipWebhook | boolean | No | — | Set skipWebhook=true, skipWebhook=1 or skipWebhook=yes to skip all webhooks upon successful operation on the endpoint. Learn more about webhooks |
maintainx_work_orders_delete_workorders_procedure_fields_attachment
Delete procedure field attachment Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | ID of the work order |
index | integer | Yes | — | Sequential index of the field in the procedure |
skipWebhook | boolean | No | — | Set skipWebhook=true, skipWebhook=1 or skipWebhook=yes to skip all webhooks upon successful operation on the endpoint. Learn more about webhooks |
maintainx_work_orders_delete_workrequestportals
Delete work request portal Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | ID of the workRequestPortal |
skipWebhook | boolean | No | — | Set skipWebhook=true, skipWebhook=1 or skipWebhook=yes to skip all webhooks upon successful operation on the endpoint. Learn more about webhooks |
maintainx_work_orders_delete_workrequests
Delete workRequest Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | ID of the workRequest |
skipWebhook | boolean | No | — | Set skipWebhook=true, skipWebhook=1 or skipWebhook=yes to skip all webhooks upon successful operation on the endpoint. Learn more about webhooks |
maintainx_work_orders_delete_workrequests_attachments
Remove work request attachment Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | ID of the work request. |
filename | string | Yes | — | Name of the attachment, including the extension. |
skipWebhook | boolean | No | — | Set skipWebhook=true, skipWebhook=1 or skipWebhook=yes to skip all webhooks upon successful operation on the endpoint. Learn more about webhooks |
maintainx_work_orders_get_workorders
Get work order Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | ID of the workOrder |
expand | string[] | No | — | To expand multiple fields: expand=assignees&expand=asset |
useSequentialId | boolean | No | — | Whether to use the sequential ID instead of the global ID |
maintainx_work_orders_get_workorders_comments
List work order comments Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | Global ID of the work order |
cursor | string | No | — | Last pagination reference |
limit | integer | No | — | max number of Comments returned |
maintainx_work_orders_get_workorders_costs
Get costs information Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | ID of the work order |
maintainx_work_orders_get_workorders_subworkorders
List sub work orders Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | Global ID of the work order |
cursor | string | No | — | Last pagination reference |
limit | integer | No | — | max number of Subworkorders returned |
expand | string[] | No | — | To expand multiple fields: expand=assignees&expand=asset |
maintainx_work_orders_get_workrequestportals
Get work request portal Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | ID of the workRequestPortal |
maintainx_work_orders_get_workrequests
Get work request Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | ID of the workRequest |
expand | string[] | No | — | To expand multiple fields: expand=asset&expand=location |
maintainx_work_orders_list_workorders
List work orders Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
cursor | string | No | — | Last pagination reference |
limit | integer | No | — | max number of Work Orders returned |
title | string | No | — | To filter work orders by title |
assets | integer[] | No | — | To filter by multiple asset IDs: assets=630&assets=634 |
notAssets | integer[] | No | — | Filter work orders that have none of the provided assets. To filter by multiple asset IDs: notAssets=630¬Assets=634 |
locations | integer[] | No | — | To filter by multiple location IDs: locations=193&locations=194&locations=195 |
notLocations | integer[] | No | — | Filter work orders that have none of the provided locations. To filter by multiple location IDs: notLocations=193¬Locations=194¬Locations=195 |
parts | integer[] | No | — | To filter by multiple part IDs: parts=14677&parts=14687 |
notParts | integer[] | No | — | Filter work orders that have none of the provided parts. To filter by multiple part IDs: notParts=14677¬Parts=14687 |
vendors | integer[] | No | — | To filter by multiple vendor IDs: vendors=7123&vendors=2234 |
notVendors | integer[] | No | — | Filter work orders that have none of the provided vendors. To filter by multiple vendor IDs: notVendors=7123¬Vendors=2234 |
assignees | integer[] | No | — | To filter by multiple assignee IDs: assignees=23494&assignees=79808 |
teams | integer[] | No | — | To filter by multiple team IDs: teams=112&teams=243 |
categories | any[] | No | — | To filter by multiple categories: categories=123456&categories=Damage |
notCategories | any[] | No | — | Filter work orders that have none of the provided categories. To filter by multiple categories: notCategories=123456¬Categories=Damage |
priorities | string[] | No | — | To filter by multiple priorities: priorities=LOW&priorities=MEDIUM |
statuses | string[] | No | — | To filter by multiple statuses: statuses=IN_PROGRESS&statuses=DONE |
show_upcoming | boolean | No | — | Include work orders with a future start date |
sort | string | No | — | Attribute on which to sort the list. (for descending order, prefix attribute with ’-’). |
expand | string[] | No | — | To expand multiple fields: expand=thumbnail&expand=assignees |
x-organization-id | integer | No | — | Required if using a multi organizations token |
maintainx_work_orders_list_workorders_comments
List work order comments Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | ID of the work order |
cursor | string | No | — | Last pagination reference |
limit | integer | No | — | max number of Comments returned |
maintainx_work_orders_list_workorders_subworkorders
List sub work orders Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | ID of the work order |
cursor | string | No | — | Last pagination reference |
limit | integer | No | — | max number of Subworkorders returned |
expand | string[] | No | — | To expand multiple fields: expand=assignees&expand=asset |
maintainx_work_orders_list_workrequestportals
List work request portals Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
cursor | string | No | — | Last pagination reference |
limit | integer | No | — | max number of Work Request Portals returned |
x-organization-id | integer | No | — | Required if using a multi organizations token |
maintainx_work_orders_list_workrequests
List work requests Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
cursor | string | No | — | Last pagination reference |
limit | integer | No | — | max number of Work Requests returned |
title | string | No | — | To filter work orders by title or sequential ID |
assets | integer[] | No | — | To filter by multiple asset IDs: assets=630&assets=634 |
locations | integer[] | No | — | To filter by multiple location IDs: locations=193&locations=194&locations=195 |
priorities | string[] | No | — | To filter by multiple priorities: priorities=LOW&priorities=MEDIUM |
statuses | string[] | No | — | To filter by multiple statuses: statuses=APPROVED&statuses=DONE |
expand | string[] | No | — | To expand multiple fields: expand=asset&expand=location |
x-organization-id | integer | No | — | Required if using a multi organizations token |
maintainx_work_orders_update_workorders
Update work order Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | ID of the work order |
skipWebhook | boolean | No | — | Set skipWebhook=true, skipWebhook=1 or skipWebhook=yes to skip all webhooks upon successful operation on the endpoint. Learn more about webhooks |
assetId | integer | No | — | Asset Id |
assignees | object[] | No | — | Either the teamId, the userId or the user email address |
categories | string[] | No | — | List of categories that identify the work order |
description | string | No | — | The description value |
dueDate | string | No | — | Date & time at which the work order is due |
estimatedTime | integer | No | — | The estimated time taken in seconds to complete the work order |
externalData | object | No | — | Extra data that can be attached to the work order, for example to help reference to a matching record in an external system. |
extraFields | object | No | — | Custom Fields on the entity. The object keys are the exact Custom Field labels, including spaces or special characters. (ie: “Estimated Time Allotted”) |
locationId | integer | No | — | Global ID of the location assigned to the work order |
partsUsed | object[] | No | — | Parts IDs and quantities used in this work order |
priority | string | No | — | The priority value |
procedure | object | No | — | The procedure value |
procedureTemplateId | number | No | — | ID of the procedure template to attach |
recurrenceInfo | object | No | — | Recurrence Info |
requesterId | object | No | — | ID or email of the user who requested the work order |
startDate | string | No | — | Date & time at which the work order will show up in the inbox</br>Only valid when <b>dueDate</b> is set |
title | string | No | — | The title value |
type | string | No | — | Valid types of Work Orders. |
vendorIds | number[] | No | — | Vendor IDs |
maintainx_work_orders_update_workorders_procedure_fields_attachment
Update procedure field attachment Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | ID of the work order |
index | integer | Yes | — | Sequential index of the field in the procedure |
filename | string | Yes | — | Name of the attachment, including the extension. |
skipWebhook | boolean | No | — | Set skipWebhook=true, skipWebhook=1 or skipWebhook=yes to skip all webhooks upon successful operation on the endpoint. Learn more about webhooks |
body | object | Yes | — | Content type should be application/octet-stream and payload should use binary format for the attachment. |
maintainx_work_orders_update_workorders_status
Update work order status Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | ID of the workOrder |
skipWebhook | boolean | No | — | Set skipWebhook=true, skipWebhook=1 or skipWebhook=yes to skip all webhooks upon successful operation on the endpoint. Learn more about webhooks |
status | string | No | — | <br /><em>Note:</em> It is also possible to register a webhook to get notified when the status of any work order changes. Please see the <a href=“#tag/Subscriptions”>Subscriptions</a> section for more information. |
maintainx_work_orders_update_workrequestportals
Update work request portal Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | ID of the work request portal |
skipWebhook | boolean | No | — | Set skipWebhook=true, skipWebhook=1 or skipWebhook=yes to skip all webhooks upon successful operation on the endpoint. Learn more about webhooks |
assetId | integer | No | — | ID of the asset related to the portal |
contactInformation | string | No | — | Contact of the person creating the portal (email or phone number) |
descriptionPlaceholder | string | No | — | Placeholder text for the description field |
emailOnly | boolean | No | — | Allow request creation with email only to contact the requester |
locationId | integer | No | — | ID of the location where the portal is located |
sendEmailNotification | boolean | No | — | Send email notifications to the portal requesters with status updates on their requests |
title | string | No | — | Title of the portal |
welcomeText | string | No | — | Description text describing the portal |
maintainx_work_orders_update_workrequests
Update work request Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | ID of the work request |
skipWebhook | boolean | No | — | Set skipWebhook=true, skipWebhook=1 or skipWebhook=yes to skip all webhooks upon successful operation on the endpoint. Learn more about webhooks |
approverTeamId | number | No | — | ID of the team that is reponsible for approving the request. |
assetId | number | No | — | Asset Id |
creatorContactInfo | string | No | — | The creator’s contact information associated with this work order request. Possible types are EMAIL, PHONE, and OTHER, which will be inferred from the string provided |
description | string | No | — | The description value |
extraFields | object | No | — | Custom Fields on the entity. The object keys are the exact Custom Field labels, including spaces or special characters. (ie: “Request Type”) |
locationId | number | No | — | Location Id |
priority | string | No | — | The priority value |
title | string | No | — | The title value |
maintainx_work_orders_upload_workorders_attachments
Update work order attachment Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | ID of the work order. |
filename | string | Yes | — | Name of the attachment, including the extension. |
skipWebhook | boolean | No | — | Set skipWebhook=true, skipWebhook=1 or skipWebhook=yes to skip all webhooks upon successful operation on the endpoint. Learn more about webhooks |
body | object | Yes | — | Content type should be application/octet-stream and payload should use binary format for the attachment. |
maintainx_work_orders_upload_workorders_thumbnail
Update work order’s thumbnail Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | ID of the work order. |
filename | string | Yes | — | Name of the work order thumbnail, including the extension. |
skipWebhook | boolean | No | — | Set skipWebhook=true, skipWebhook=1 or skipWebhook=yes to skip all webhooks upon successful operation on the endpoint. Learn more about webhooks |
body | object | Yes | — | Content type should be application/octet-stream and payload should use binary format for the thumbnail. |
maintainx_work_orders_upload_workrequests_attachments
Update work request attachment Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | ID of the work request. |
filename | string | Yes | — | Name of the attachment, including the extension. |
skipWebhook | boolean | No | — | Set skipWebhook=true, skipWebhook=1 or skipWebhook=yes to skip all webhooks upon successful operation on the endpoint. Learn more about webhooks |
body | object | Yes | — | Content type should be application/octet-stream and payload should use binary format for the attachment. |
maintainx_work_orders_upload_workrequests_thumbnail
Update work request’s thumbnail Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | ID of the work request. |
filename | string | Yes | — | Name of the work request thumbnail, including the extension. |
skipWebhook | boolean | No | — | Set skipWebhook=true, skipWebhook=1 or skipWebhook=yes to skip all webhooks upon successful operation on the endpoint. Learn more about webhooks |
body | object | Yes | — | Content type should be application/octet-stream and payload should use binary format for the thumbnail. |

