Delete Machine Custom Data
Deletes custom data records for the specified machines. At least one machine identifier must be provided.
| Verb | DELETE |
|---|---|
| Endpoint | {base-url}/machines/custom-data |
| Max Page Size | N/A |
Request Body
{
"requestFilter": {
"machineIdentifiers": ["PROSE123456789"]
}
}
Filters Honored
- RequestFilter
- machineIdentifiers
Note
All changes in this request are atomic. If any item fails, the entire batch is rolled back and no changes are made.
Note
Successfully deleting custom data sets hardwareSettingsChanged to true on each affected machine. The controller will download the updated settings the next time it comes online.
Returns
On Success
A 204 No Content.
On Error
| HTTP Code | Error |
|---|---|
| 400 | No machine identifiers were specified. You must specify one or more to delete custom data for. |
| 403 | One or more of the specified machines is outside the organizations you have access to. |
| 404 | One or more of the specified machines does not exist. |