How To
Summary
This document describes the steps to provide the correct data for Preventive Maintenance records created via API to generate Work Orders.
Objective
For Preventive Maintenance (PM) records created via API, the attribute usefrequency should not be mentioned. This field is automatically set to true by the system for top-level PMs, so even if usefrequency=0 is passed, it will override the value after save, which triggers an internal modification flag and prevents immediate work order generation. To avoid this behavior, do not include the usefrequency field when creating PMs via API.
Steps
Please follow the steps:
1. Go to Object Structures application;
2. Create an object structure for Preventive Maintenance (PM);
3. Provide the security authorization and grant accesses in Security Groups following the documentation:
How to configure Object Structure Security
4. In an API tool, create a PM record with the following:
Url: https://hostname/maximo/api/os/OBJECTSTRUCTURE?lean=1
Header:; apikey
Body:
{
"pmnum": "TEST",
"description": "Test",
"siteid": "BEDFORD",
"status": "ACTIVE",
"assetnum": "CAL101",
"jpnum": "JPCAL101",
"laststartdate":"2026-01-12T12:21:09-05:00",
"lastcompdate":"2026-01-05T12:21:09-05:00",
"usetargetdate":1,
"frequency":14,
"frequnit":"DAYS",
"wostatus": "APPR",
"erlstwogendate":"2026-01-26T12:21:09-05:00"
}
5. After the record is created, go to Preventive Maintenance application and search for the PM created;
6. Click Generate Work Orders.
Document Location
Worldwide
Was this topic helpful?
Document Information
Modified date:
17 February 2026
UID
ibm17261046