---
title: "Return whether system needs reboot"
method: GET
path: "/system_needs_reboot"
tags: ["Server Administration", "System Information"]
---

# Return whether system needs reboot

`GET /system_needs_reboot`

This function determines if your system requires a reboot to apply quotas, software package updates, or kernel updates.

**Important:**

This function **cannot** detect whether your system needs a reboot if you use cPanel & WHM inside of a [Linux Container (LXC)](https://docs.cpanel.net/knowledge-base/general-systems-administration/linux-containers/).

## Response `200`

HTTP Request was successful.

- object
  - `details` object — An object that contains reasons why the system requires a reboot.
    - `kernel` object — An object of kernel versions. **Note:** The function **only** returns this object if the kernel updates and requires a reboot.
      - `boot_version` string — The version that the system's kernel updated to.
      - `running_version` string — The kernel version that the server currently runs.
    - `quota` 1 — Whether the system requires a reboot to enable quotas. * `1` — System requires a reboot to enable quotas. **Note:** The function **only** returns this value if the kernel updates and requires a reboot.
    - `updates` object — A list of software packages that require an update and their most recent versions. **Note:** The function **only** returns this object if software packages on your server require updates.
  - `metadata` object
    - `command` string — The method name called.
    - `reason` string — The reason the API function failed when the `metadata.result` field is `0`. This field may display a success message when a function succeeds.
    - `result` 0 | 1 — * `1` - Success * `0` - Failed: Check the reason field for more details.
    - `version` integer — The version of the API function.
  - `needs_reboot` 0 | 1 — Whether the system requires a reboot. * `1` — System requires a reboot. * `0` — System does **not** require a reboot.

---

[API](https://skmtc.net/cpanel/apis/whm-api.md) · [All operations](https://skmtc.net/cpanel/apis/whm-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cpanel/whm-api/revisions/3da41671c02c/schema)