Device Management Commands

Commands related to devices for end-users and Admins

Overview

This section lists all the commands in Keeper SDKs that are related to managing devices registered to a Keeper account. "Device management commands" in this context are things like listing devices, renaming devices, logging out sessions, and linking/unlinking devices for persistent login. The commands cover viewing, controlling, and securing Keeper sessions across desktops, mobiles, and other clients.

The SDK currently supports these commands.

User commands (account scope)

• Device List

• Device Rename

• Device Action

  • Logout

  • Remove

  • Lock

  • Unlock

  • Account lock

  • Account unlock

  • Link

  • Unlink

• This Device

Enterprise admin commands (enterprise scope)

• Device Admin

  • Device admin list

  • Device admin action

  • Logout

  • Remove

• Device Approve

Enterprise admins can list devices for enterprise users. They can also log users out or remove selected devices remotely. Device approve supports Cloud SSO device approval workflows.

Device List

Lists all active devices for the current user.

DotNet CLI

Command: devices

SubCommand : list

Parameters:

-f, --force (Default: false) reload device list

-l, --link (Default: false) link device

--help Display this help screen.

--version Display version information.

value pos. 0 device command: "approve", "decline", "list"

value pos. 1 device id or "all" or "clear"

Example:

My Vault> devices list

  #  Device Name              Client                     ID                    Status  Data Key
---  -----------------------  -------------------------  --------------------  ------  --------
  1  Web Vault Chrome         Web App 17.4.0             <     ID1          >  OK      Yes     
  2  Users_phone              Android 17.3.30            <     ID2          >  OK      Yes     
  5  Browser Extension        Browser Extensions 17.3.2  <     ID3          >  OK      Yes     
  6  OFF                      Commander 17.0.0           <     ID4          >  OK      Yes     
  8  Web Vault Edge           Web App 17.3.3             <     ID5          >  OK      Yes     
  9  Python Keeper API        Commander 17.0.0           <     ID6          >  OK      No      
 10  .NET Keeper API          Commander 17.0.0           <     ID7          >  OK      No      
 14  Web Vault Firefox        Web App 17.4.0             <     ID8          >  OK      Yes     
 15  Firefox,MacIntel         EMConsole 17.6.0           <     ID9          >  OK      No      
 16  PowerShell Commander     Commander 17.0.0           <     ID10         >  OK      Yes     
 17  Commander CLI on macOS   Commander 17.1.9           <     ID11         >  OK      No      
 18  Commander C#             Commander 17.0.0           <     ID12         >  OK      No      
 19  Commander CLI on win32   Commander 17.1.0           <     ID13         >  OK      Yes     
 27  Desktop                  DesktopElectron 17.2.1     <     ID14         >  OK      Yes     

DotNet SDK

Coming Soon

PowerCommander

Coming Soon

Python CLI

Command: device-list

Syntax:

device-list [--format=FORMAT] [--output=FILE]

Parameters:

• --format Output format. Values: table or json. Default: table

• --output Output file name. Ignored for table format

Examples:

My Vault> device-list
User Devices (3 found)
ID  Device Name      Client Type       Login Status  Last Accessed
1   My iPhone        IOS               LOGGED_IN     2025-01-15 10:30:25
2   Work Laptop      CHROME_EXTENSION  LOGGED_IN     2025-01-15 09:15:42
3   Home Desktop     DESKTOP           LOGGED_OUT    2025-01-14 18:22:15

My Vault> device-list --format=json
{
  "devices": [
    {
      "id": 1,
      "deviceName": "My iPhone",
      "clientType": "IOS",
      "loginStatus": "LOGGED_IN",
      "lastAccessedTimestamp": "2025-01-15 10:30:25"
    },
    {
      "id": 2,
      "deviceName": "Work Laptop",
      "clientType": "CHROME_EXTENSION",
      "loginStatus": "LOGGED_IN",
      "lastAccessedTimestamp": "2025-01-15 09:15:42"
    }
  ]
}

My Vault> device-list --format=json --output=my_devices.json
Results saved to my_devices.json

Python SDK

Function: list_user_devices

Example:

from keepersdk.authentication import device_management

# auth: logged-in KeeperAuth session (after login)
devices = device_management.list_user_devices(auth)

# Each device is a UserDeviceInfo object, sorted by last access (newest first)
for d in devices:
    print(
        d.list_index,      # Device ID from device-list (1, 2, 3...) — use for device-action / device-rename
        d.name,            # Device name (e.g. "MacBook Pro", "iPhone 15")
        d.client_type,     # Client type (e.g. Web Vault, Mobile, Desktop)
        d.login_status,    # Whether the user is currently logged in on this device
        d.last_accessed,   # datetime of last access, or None if unavailable
    )

Device Rename

Rename your devices to more descriptive names.

DotNet CLI

Coming Soon

DotNet SDK

Coming Soon

PowerCommander

Coming Soon

Python CLI

Command: device-rename

Syntax:

device-rename <Device ID / Device Name> <NEW_NAME>

Parameters:

• DEVICE Device ID such as 1, 2, 3, or a device name

• NEW_NAME New name for the device

Examples:

My Vault> device-rename 1 "My New iPhone"
✓ Device name updated from 'My iPhone' to 'My New iPhone'

Updated device list:
User Devices (3 found)
ID  Device Name        Client Type       Login Status  Last Accessed
1   My New iPhone      IOS               LOGGED_IN     2025-01-15 10:40:33
2   Work Laptop        CHROME_EXTENSION  LOGGED_IN     2025-01-15 09:15:42
3   Home Desktop       DESKTOP           LOGGED_OUT    2025-01-14 18:22:15

My Vault> device-rename "Work Laptop" "Updated Work Laptop"
✓ Device name updated from 'Work Laptop' to 'Updated Work Laptop'

Python SDK

Function: rename_user_device

Example:

from keepersdk.authentication import device_management

# auth: logged-in KeeperAuth session (after login)

# Identify the device by list ID (from device-list) or exact device name
device_identifier = '1'          # e.g. ID from list_user_devices
new_device_name = 'Work Laptop'  # new name to assign

# Rename the device; returns (old_name, new_name) on success
old_name, updated_name = device_management.rename_user_device(
    auth,
    device_identifier,
    new_device_name,
)

print(f'Device renamed from "{old_name}" to "{updated_name}"')

# Optional: list devices again to confirm the update
devices = device_management.list_user_devices(auth)
for d in devices:
    print(d.list_index, d.name, d.client_type, d.login_status, d.last_accessed)