kosli list controls

List controls for an org.

This is a beta feature. Beta features provide early access to product functionality. These features may change between releases without warning, or can be removed in a future release. Please contact us to enable this feature for your organization.

Synopsis

kosli list controls [flags]

List controls for an org. The results are paginated; use —page and —page-limit to navigate the pages.

Flags

Flag	Description
--archived	[optional] List archived controls instead of active ones.
-h, --help	help for controls
-o, --output string	[defaulted] The format of the output. Valid formats are: [table, json]. (default “table”)
--page int	[defaulted] The page number of a response. (default 1)
-n, --page-limit int	[defaulted] The number of elements per page. (default 15)
--search string	[optional] Only list controls whose name or identifier contains this substring (case-insensitive).
--sort-direction string	[optional] The direction to sort controls in. Valid values are: [asc, desc]. (defaults to asc)
--tag stringArray	[optional] Filter by tag, given as ‘key’ or ‘key:value’. Can be repeated to match more than one tag.

Flags inherited from parent commands

Flag	Description
-a, --api-token string	The Kosli API token.
-c, --config-file string	[optional] The Kosli config file path. (default “kosli”)
--debug	[optional] Print debug logs to stdout.
-H, --host string	[defaulted] The Kosli endpoint. (default “https://app.kosli.com”)
--http-proxy string	[optional] The HTTP proxy URL including protocol and port number. e.g. http://proxy-server-ip:proxy-port
-r, --max-api-retries int	[defaulted] How many times should API calls be retried when the API host is not reachable. (default 3)
--org string	The Kosli organization.
-q, --quiet	[optional] Suppress non-critical warning messages. Errors and normal output are not affected. If both --quiet and --debug are set, --debug wins.

Examples Use Cases

These examples all assume that the flags --api-token, --org, --host, (and --flow, --trail when required), are set/provided.

list the first page of controls for an org

kosli list controls 

list the second page of controls (10 per page) in JSON

kosli list controls 
	--page 2 
	--page-limit 10 
	--output json 

list controls whose name or identifier contains 'sdlc'

kosli list controls 
	--search sdlc 

list controls tagged framework=finos-sdlc (--tag can be repeated)

kosli list controls 
	--tag framework:finos-sdlc 

list archived controls instead of active ones

kosli list controls 
	--archived 

list controls sorted in descending name order

kosli list controls 
	--sort-direction desc