Update Machine Custom Data

Updates custom data for the specified machines. Custom data must already exist for the given machine. Use the create endpoint to create new records.

Verb	PATCH
Endpoint	{base-url}/machines/custom-data
Max Page Size	N/A

Request Body

{
  "body": [
    {
      "machineId": 1166,
      "customData1": "updated-value",
      "customData2": "value2",
      "customData3": null,
      "customData4": null,
      "customData5": null
    }
  ]
}

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 updating 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 Code	Definition
403	DATA_ACCESS_VIOLATION	One or more custom datas were associated with machines in organizations you do not have access to.
404	MISSING_RECORD	One or more of the specified machines does not exist.
403	DATA_ACCESS_VIOLATION	One or more of the machines you specified is not associated with a model and cannot have custom data.
400	NOT_SUPPORTED	Machine {id} is a model that does not support custom data.
400	INVALID_DATA_TYPE	One of the custom datas for machine {id} was not of the correct type.