> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hoplynk.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Commands

> Return all commands available on an asset — PTZ moves, arm/disarm, mode changes, etc.

<ParamField path="kit_id" type="string" required>
  UUID of the kit.
</ParamField>

<ParamField path="asset_id" type="string" required>
  UUID of the asset.
</ParamField>

## Response

<ResponseField name="commands" type="array">
  List of enabled command definitions.

  <Expandable title="Command fields">
    <ResponseField name="id" type="string">Command UUID.</ResponseField>

    <ResponseField name="name" type="string">
      Command identifier used in [Send Command](/api-reference/assets/send-command) (e.g. `ptz_move`, `arm`, `reboot`).
    </ResponseField>

    <ResponseField name="description" type="string">
      Human-readable description of what the command does.
    </ResponseField>

    <ResponseField name="risk_level" type="string">
      `low` · `medium` · `high` — indicates how carefully the command should be confirmed before sending.
    </ResponseField>

    <ResponseField name="requires_approval" type="boolean">
      If `true`, the Argus dashboard will show an extra confirmation dialog before dispatching.
    </ResponseField>

    <ResponseField name="input_schema" type="object">
      JSON Schema object that describes the `payload` required by [Send Command](/api-reference/assets/send-command). An empty object `{}` means no payload is needed.
    </ResponseField>
  </Expandable>
</ResponseField>

## Example

<CodeGroup>
  ```python Python theme={null}
  result = client.get_commands(kit_id, asset_id)
  for cmd in result["commands"]:
      print(f"{cmd['name']}  [{cmd['risk_level']}]  {cmd['description']}")
  ```

  ```bash cURL theme={null}
  curl https://argus.hoplynk.com/api/kits/$KIT_ID/assets/$ASSET_ID/commands \
    -H "X-API-Key: hlk_..."
  ```
</CodeGroup>

```json Response (drone) theme={null}
{
  "commands": [
    {
      "id": "a1b2c3d4-...",
      "name": "arm",
      "description": "Arm the vehicle motors.",
      "risk_level": "high",
      "requires_approval": true,
      "input_schema": {}
    },
    {
      "id": "b2c3d4e5-...",
      "name": "disarm",
      "description": "Disarm the vehicle motors.",
      "risk_level": "medium",
      "requires_approval": false,
      "input_schema": {}
    },
    {
      "id": "c3d4e5f6-...",
      "name": "set_mode",
      "description": "Set the flight mode.",
      "risk_level": "medium",
      "requires_approval": false,
      "input_schema": {
        "type": "object",
        "properties": {
          "mode": {
            "type": "string",
            "enum": ["GUIDED", "AUTO", "LOITER", "RTL", "LAND"]
          }
        },
        "required": ["mode"]
      }
    },
    {
      "id": "d4e5f6g7-...",
      "name": "goto_waypoint",
      "description": "Fly to a lat/lon/alt waypoint in GUIDED mode.",
      "risk_level": "medium",
      "requires_approval": false,
      "input_schema": {
        "type": "object",
        "properties": {
          "lat": { "type": "number" },
          "lon": { "type": "number" },
          "alt_m": { "type": "number" }
        },
        "required": ["lat", "lon", "alt_m"]
      }
    }
  ]
}
```