# Input

List details of input devices. ADMIN privilege is required for these functions.

### hardware/tree

Lists the parameters, options and settings for input devices.

* `uuid` (Required). If set to 'root', the top-level details of the input device(s) are shown. If the uuid of a device (obtained from the top-level details) is submitted, full information is shown similar to Configuration -> DVB Inputs -> TV Adaptors.
* `root` Function obscure.

```
[
   {
      "leaf" : 0,
      "uuid" : "efe25f71ce456f99bb5a1b600b2e8143",
      "class" : "linuxdvb_adapter",
      "params" : [
         {
            "nosave" : true,
            "caption" : "Active",
            "id" : "active",
            "default" : false,
            "rdonly" : true,
            "noui" : true,
            "value" : true,
            "type" : "bool"
         },
         {
            "caption" : "Device path",
            "type" : "str",
            "id" : "rootpath",
            "rdonly" : true,
            "default" : "",
            "value" : "/dev/dvb/adapter0",
            "description" : "Path used by the device."
         }
      ],
      "text" : "/dev/dvb/adapter0 [Montage Technology M88DS3103 #0]",
      "caption" : "LinuxDVB adapter",
      "id" : "efe25f71ce456f99bb5a1b600b2e8143",
      "event" : "linuxdvb_adapter"
   }
]
```

### hardware/satip/discover

Triggers a discovery process for SAT>IP servers, as Configuration -> General -> SAT>IP Server -> Discover SAT>IP Servers in the GUI. This function is only available if SAT>IP client functionality has been compiled into TVHeadend.

The `op` parameter must be set to `all`.

Example: `/api/hardware/satip/discover?op=all`


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.tvheadend.org/documentation/development/json-api/api-description/input.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.