NSF Folders Commands
Nested Shared Folders for folder-level commands
Overview
With the introduction of Nested Shared Folders with Role-Based Folder Permissions, we’ve rebuilt the vault’s folder, sharing and permissions model from the ground up, delivering a more flexible and scalable experience for every user and team.
Operations Supported
The Following operations are supported by NSF Shared Folders
Note: In case you are using classic permission model, please refer to Shared Folder Commands
Create Folder command
Creates a new folder in Keeper NSF using the v3 API. Optionally places the folder under a parent, assigns a color, and controls whether permissions are inherited from the parent.
DotNet CLI
Command: nsf-mkdir
Parameters:
Parameter
Description
--name
Name of the folder to create (required)
--parent
UID of the parent folder. If omitted, the folder is created at the Keeper NSF root
--color
Optional folder color
--no-inherit
If specified, the new folder will not inherit permissions from its parent
Examples:
Power Commander
Command: New-KeeperNSFFolder
Alias: nsf-mkdir
Parameters:
Parameter
Description
-Name
Name of the folder to create (required)
-ParentFolderUid
UID of the parent folder. If omitted, the folder is created at the Keeper NSF root
-Color
Optional folder color
-NoInheritPermissions
If specified, the new folder will not inherit permissions from its parent
Examples:
Python CLI
Command: nsf-mkdir
Parameters:
folder Folder name (use "//" to embed a literal "/" in the name)
--color {none, red, orange, yellow, green, blue, gray} Folder colour
--no-inherit Do not inherit parent folder permissions
Example:
Update folder command
Renames a Keeper NSF folder and/or changes its color. Folder can be referenced by UID or by name.
DotNet CLI
Command: nsf-rndir
Parameters:
--name
New folder name
--color
New folder color: none, red, orange, yellow, green, blue, gray, grey
Examples:
Power Commander
Command: Set-KeeperNSFFolder
Alias: nsf-rndir
Parameters:
-Folder
Folder UID or name (required)
-Name
New folder name
-Color
New folder color: none, red, orange, yellow, green, blue, gray, grey
Examples:
Python CLI
Command: nsf-rndir
Parameters:
folder folder path or UID
-n, --name NAME - folder new name
--color {none, red, orange, yellow, green, blue, gray} Folder color
-q, --quiet Suppress success message
Example:
Remove folder command
Removes one or more Keeper NSF folders. Always runs a preview first, prints the impact, and asks for confirmation unless -Force is supplied.
DotNet CLI
Command: nsf-rmdir
Parameters:
-o or --operation
folder-trash (default, recoverable) or delete-permanent (irreversible cascade delete)
-f or --force
Skip the confirmation prompt after preview
--dry-run
Preview only; do not remove folders
Examples:
Power Commander
Command: Remove-KeeperNSFFolder
Alias: nsf-rmdir
Parameters:
-Folder
One or more folder UIDs or names. Accepts pipeline input
-Operation
folder-trash (default, recoverable) or delete-permanent (irreversible cascade delete)
-Force
Skip the confirmation prompt after preview
-DryRun
Preview only; do not remove folders
Examples:
Python CLI
Command: Not implemented
Parameters:
FOLDER Folder UID(s) or name(s) to remove (max 100)
--operation, -o {folder-trash, delete-permanent} Removal operation (default: folder-trash)
-q, --quiet Suppress per-folder impact detail
--force, -f Skip confirmation after preview
--dry-run Preview only; do not delete
Example:
Share Folder command
Grants or removes user access on a Keeper NSF folder.
DotNet CLI
Command: nsf-share-folder
Parameters:
position 0
UID of the folder to share (required)
--action
grant (default) or remove
--email
One or more user email addresses to grant or revoke access for (required)
--role
Access role for grant: viewer (default), shared-manager, content-manager, content-share-manager, full-manager
Examples:
Power Commander
Command: Set-KeeperNSFFolderAccess
Alias: nsf-share-folder
Parameters:
-FolderUid
UID of the folder to share (required)
-Action
grant (default) or remove
-Email
One or more user email addresses to grant or revoke access for (required)
-Role
Access role for grant: viewer (default), shared-manager, content-manager, content-share-manager, full-manager
Examples:
Python CLI
Command: nsf-share-folder
Parameters:
folder folder UID or name
-a, --action {grant, remove} grant (default) or remove access
-e, --email USER email, team name/UID, or @existing for all folder accessors
-r, --role {viewer, share-manager, content-manager, content-share-manager, full-manager}
--expire-at TIMESTAMP
--expire-in PERIOD
Example:
Link Record to Folder command
Links (hard-links) a Keeper NSF record into a Keeper NSF folder, so the record appears in additional folders without being copied.
DotNet CLI
Command: nsf-ln
Parameters:
position 0
Record UID or title (required)
position 1
Destination folder UID, name, or / for the Keeper NSF root (required)
Examples:
Power Commander
Command: Link-KeeperNSFRecord
Alias: nsf-ln
Parameters:
-Record
Record UID or title (required)
-Folder
Destination folder UID, name, or / for the Keeper NSF root (required)
Examples:
Python CLI
Command: nsf-ln
Parameters:
src record UID or title
dst destination folder UID or name
Example:
Remove/Unlink Record command
Removes one or more Keeper NSF records using the v3 remove API. Always runs a preview first, prints the impact, and asks for confirmation unless -Force is supplied.
DotNet CLI
Command: nsf-rm
Parameters:
--folder
Folder UID or name that provides context (required for unlink)
-o or --operation
owner-trash (default), folder-trash, or unlink
-f or --force
Skip the confirmation prompt after preview
--dry-run
Preview only; do not remove records
Examples:
Power Commander
Command: Remove-KeeperNSFRecord
Alias: nsf-rm
Parameters:
-Record
One or more record UIDs or titles. Accepts pipeline input
-Folder
Folder UID or name that provides context (required for unlink)
-Operation
owner-trash (default), folder-trash, or unlink
-Force
Skip the confirmation prompt after preview
-DryRun
Preview only; do not remove records
Examples:
Python CLI
Command: nsf-rm
Parameters:
RECORD Record UID(s) or title(s) to remove (max 500)
--folder FOLDER Folder UID or name for operation context
--operation, -o {owner-trash,folder-trash,unlink}
Removal operation (default: owner-trash)
--force, -f Skip confirmation after preview
--dry-run Preview only; do not delete
Example:
Last updated

