Skip to content

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

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.