Commands for creating and managing Record Types and Custom Templates
The commands associated with Record Types are listed below. For more information on record types, including example usage, see the documentation
Whether using the interactive shell, CLI or JSON config file, Keeper supports the following commands, each command supports additional parameters and options.
To get help on a particular command, run:
help <command>
Command: record-type-info
or rti
Detail: List available record types. or details of a specific record type
Switches:
-lr
, --list-record <RECORD TYPE OR ID (optional)>
If record type name or ID is not given, lists all record type names and IDs
if a record type name or ID is given, displays the record type's details and fields
-lf
, --list-field <FIELD NAME>
show information about a specified field type. Can use "*" to show all fields.
-e
, --example
generate example json for a record type or field. *Must use with -lr or -lf
--syntax-help
display extended help on record type parameters
--format <{csv, json, table}>
choose the format to output in
--output <OUTPUT FILE>
output results to a given file *ignored if table format is used
Examples:
show list of record types
show details of the login record type
show details of the name field type
show details of all field types
display an example of the passport record type
display extended syntax help text
write the record type information as a CSV to a file
Command: record-type
or rt
Detail: Add, modify, or delete custom record types
Parameters:
Record type ID (if updating or deleting)
Switches:
-a
, --action <{add, update, remove}>
action to perform
add - create a new custom record type
update - modify an existing custom record type
remove - delete an existing custom record type
--data <DATA>
JSON formatted definition of the record type
Format:
Record types utilize the following formatting:
Example:
See a list of all field types here
Use the following command to see a list of available field types: rti -lf *
Examples:
Add a new record type named "My Record Type"
Update the "My Record Type" record Type (which has an ID of 102 in this example). Here, the 'Address' field was removed
Remove the record type with Id 102
Required Version: v16.5.9+
Command: convert
Detail: Convert legacy (General typed or untyped) records to typed records.
The convert command will only convert legacy, untyped records to typed records.
To convert the type of a typed record, use the edit command.
Parameters:
Pattern to match records in the current folder. Matches against UIDs and titles. Can use "?" to match any single character and "*" to match any number of characters
Switches:
-t
, --record-type <RECORD TYPE OR ID >
The type to convert records to
see record types documentation for a list of all standard record types
-q
, --quiet
Do not show info about matched and converted records
-u
, --url <URL Pattern>
Only converts records with URLs that match the given pattern. Can use "?" to match any single character and "*" to match any number of characters
-n
, --dry-run
Display the outcome of the conversion without converting any records
-r
, --recursive
apply conversion to all matching records in the current and child folders
--ignore-ownership
convert records even if they are not owned by the current account
Examples:
Convert the untyped record with the given UID to a login type record
Perform a dry-run of conversion of all records in the vault and display what records would be converted. (will match all records if performed at the root directory)
Convert all untyped records in the vault to login type (if performed at the root directory)
Convert any untyped record that contains 'sql' in its name to a database credential
Convert any record that ends in ssh-<anything> to a sshKey type record
e.g convert a record titled "Github ssh-1" and a record titled "Github ssh-2"
Command
Explanation
record-type-info
or rti
List record types or see information about a specific record type
record-type
or rt
Add, edit, or delete custom record types
convert
Convert legacy records to record-typed records