PUT /unmanageOffline

Use this PUT method to configure settings for automatically unmanaging devices that are offline for specific amount of time.

  • Automatic unmanagement of offline devices is supported for Flex System chassis, switches, Lenovo Flex System servers, Lenovo System x servers, ThinkAgile, and ThinkSystem servers.

  • This API requires Lenovo XClarity Administrator v2.6.0 or later.


Authentication with user name and password is required.

Request URL

PUT https://<management_server_IP>/unmanageOffline

Query parameters


Request body

Parameter Required / Optional Type Description
offlinePeriod Optional Integer Amount of time, in hours, that devices must be offline before they are automatically unmanaged

This value can be from 1 – 24 hours. The default is 24 hours.

unmanageOffline Required Boolean Indicates whether Lenovo XClarity Administrator automatically unmanages devices that are offline for the a specific amount of time. This can be one of the following values.
  • true. Enables automatic unmanagement of offline devices.

    XClarity Administrator checks for offline devices every hour. If a device is offline for at least the amount of time specified by offlinePeriod, XClarity Administrator automatically unmanages that device.

  • false. Disables automatic unmanagement of offline devices.

Request example

   "offlinePeriod": 48,
   "unmanageOffline": "true"

Response codes

Code Description
200 OK
400 Bad request
404 Not found
500 Internal server error

Response body