kosli_list_artifacts.md

title	kosli list artifacts
description	List artifacts in a flow or repo.

Synopsis

kosli list artifacts [flags]

List artifacts in a flow or repo. The results are paginated and ordered from latest to oldest. By default, the page limit is 15 artifacts per page.

Flags

Flag	Type	Description
-f, --flow	string	The Kosli flow name.
-h, --help	bool	help for artifacts
-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)
--repo	string	[optional] The name of a git repo as it is registered in Kosli. e.g kosli-dev/cli

Flags inherited from parent commands

Flag	Type	Description
-a, --api-token	string	The Kosli API token.
-c, --config-file	string	[optional] The Kosli config file path. Config is read from this path or the default only, never implicitly from the current directory. (default "$HOME/.kosli.yml")
--debug	bool	[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	bool	[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.

```shell kosli list artifacts

</Accordion>
<Accordion title="list the last 15 artifacts for a repo">
```shell
kosli list artifacts 
	--repo yourRepoName 

```shell kosli list artifacts --page-limit 30

</Accordion>
<Accordion title="list the last 30 artifacts for a flow (in JSON)">
```shell
kosli list artifacts 
	--page-limit 30 
	--output json