Skip to main content

Team IDs

Accessing a Team from the CLI requires knowledge of the ID for the Team, as well as IDs for individual members and collections.

Retrieve this information directly from the CLI using bsafe list (list), for example:

bsafe list organizations
bsafe list org-members --organizationid 4016326f-98b6-42ff-b9fc-ac63014988f5
bsafe list org-collections --organizationid 4016326f-98b6-42ff-b9fc-ac63014988

You can bsafe list both collections and org-collections.

  • bsafe list collections will list all collections, regardless of the Team to which they belong.

  • bsafe list org-collections will list only collections that belong to the Team specified using --organizationid.

list

The list command retrieves an array of objects from your safe:

bsafe list (items|folders|collections|organizations|org-collections|org-members) [options]

Options for the list command are filters used to dictate what will be returned, including:

  • --url <url>

  • --folderid <folderid>

  • --collectionid <collectionid>

  • --organizationid <organizationid>

  • --trash

Any filter will accept null or notnull. Combining multiple filters in one command will perform a logical OR operation; for example, the following command returns items that are not in a folder or collection.

bsafe list items --folderid null --collectionid null

Additionally, you can search for specific objects using --search <search-term>. Combining filter and search in one command will perform a logical AND operation. For example, the following command searches for items with the string github in the specified folder:

bsafe list items --search github --folderid 9742101e-68b8-4a07-b5b1-9578b5f88e
In this section: