# Shared Folder Commands
## Overview
This page catalogs and provides detailed information about shared folders lists and teams.
1. [List-Share-Folder](#list-share-folder)
2. [Share Folder - Change Record Permissions Command](#share-folder-change-record-permissions-command)
## Command
### List Share Folder Command
Lists the shared folders within a specified folder or the current directory in your Keeper vault.
DotNet CLI
**Command:** `sf-list`
**Example:**
```bash
My Vault> sf-list
# Shared Folder UID Name # Records # Users
--- ---------------------- ------------------------------- --------- -------
1 shared_folder_uid Test-Shared-Folder 11 1
```
DotNet SDK
**Function:**
```csharp
var sharedFolders = vault.SharedFolders;
```
Power Commander
**Command:** `Get-KeeperSharedFolder`
**Flag:**
* `-Uid` : Uid of the Shared Folder
* `-Filter` : Used to filter the shared folders.
**Example:**
```powershell
PS> Get-KeeperSharedFolder
Uid Name DefaultManageRecords DefaultManageUsers DefaultCanEdit DefaultCanShare UserCount RecordCount
--- ---- -------------------- ------------------ -------------- --------------- --------- -----------
shared_folder_uid example_new_shared_folder True True True True 1 1
```
Python CLI
**Command:** `list-sf`
**Options:**
* `pattern` : Pattern of the title or UID of the shared folder.
* `-h, --help` : show this help message and exit
* `--format` : Specifies the output format of the `list-sf` command. The available options are:
* ***table:*** The Output will be displayed in table format. By default, the output will be in table format.
* Example: `--format table`
* ***csv:*** The Output will be displayed in csv format.
* Example: `--format csv`
* ***json***** :** The Output will be displayed in json format.
* Example: `--format json`
* `--output` : Users can use this flag to store the output in a file. This flag should not be used when the output format is set to table (`--format table`).
* Example: `--output `
* `--verbose, -v` : verbose output
**Example:**
```
My Vault> list-sf
# Shared Folder UID Name
--- ---------------------- -----------------------------------------
1 shared_folder_uid Test Example Folder
```
Python SDK
**Function:** `find_shared_folders`
```python
find_shared_folders(self, criteria: str) -> Iterable[vault_types.SharedFolderInfo]
```
**Example:**
```python
shared_folders = vault.vault_data.find_shared_folders(criteria=pattern)
```
### Shared Folder - Change Record Permissions Command
Allows users to change the permissions of records within a shared folder. Users can add or revoke permissions for individual records as needed.
DotNet CLI
**Command:** `sf-record`
**Flag:**
* `-r, --record` : The record name or record UID of the item that needs to be shared within the shared folder.
* `-s, --can-share` : A Boolean value (`true` or `false`). If `true`, the user has share permission. If `false`, the edit permission will be removed.
* `-e, --can-edit` : A Boolean value (`true` or `false`). If `true`, the user has edit permission. If `false`, the edit permission will be removed.
* `--expire-at` : Expire share at ISO time: YYYY-MM-DD HH:mm:SS
* `--expire-in` : Expire share in period: \[N]mi|h|d|mo (Minutes / hours / days / months)
* `--help` : Display this help screen.
* `--version` : Display version information.
* `folder name (pos. 0)` : Required. folder name
**Example:**
```bash
My Vault> sf-record record_uid
# Record Title Record UID Can Edit Can Share Expiration
--- ------------- ---------------------- -------- --------- ----------
1 ABC record_uid X X
2 Gmail Account record_uid X X
3 Gmail Account record_uid X X
My Vault> sf-record folder_uid --record=record_uid --expire-in=30mi
My Vault> sf-record BRvqCEzmFM9rVqkmpeGs6A
# Record Title Record UID Can Edit Can Share Expiration
--- ------------- ---------------------- -------- --------- ----------------
1 ABC record_uid X X 03-11-2025 18:08
2 Gmail Account record_uid X X
3 Gmail Account record_uid X X
```
DotNet SDK
**Function:** `ChangeRecordInSharedFolder`
```csharp
public async Task ChangeRecordInSharedFolder(string sharedFolderUid, string recordUid, IRecordShareOptions options)
```
**Example:**
```csharp
await context.Vault.ChangeRecordInSharedFolder(sf.Uid, recordUid, shareOptions);
```
Power Commander
**Command** : Coming Soon
Python CLI
**Command**: `record-permission`
**Parameters**:
* `-a`, `--action` Grant or Revoke (required)
* `folder` Shared folder uid to which the changes need to be applied (required)
**Options**:
* `--dry-run` Display the permissions changes without committing them
* `--force` Apply permission changes without any confirmation
* `-R`, `--recursive` Apply permission changes to all sub-folders
* `--share-record` Change a records sharing permissions
* `--share-folder` Change a folders sharing permissions
* `-s`, `--can-share` Set record permission: can be shared
* `-d`, `--can-edit` Set record permission: can be edited
* **--can-edit or --can-share is required**
* **Example:**
```sh
My Vault> record-permission -a grant --share-record -s -d shared_folder_uid
Request to GRANT "Can Edit" & "Can Share" permission(s) in "my_share" folder only
```
Python SDK
**Command** : Coming Soon
### Shared Folder - share/unshare with user without sync-down
Shares Shared Folder with user
DotNet SDK
Python SDK
**Command** : Coming Soon