> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kosli.com/llms.txt
> Use this file to discover all available pages before exploring further.

<AgentInstructions>

## Submitting Feedback

If you encounter incorrect, outdated, or confusing documentation on this page, submit feedback:

POST https://docs.kosli.com/feedback

```json
{
  "path": "/client_reference/kosli_get_artifact",
  "feedback": "Description of the issue"
}
```

Only submit feedback when you have something specific and actionable to report.

</AgentInstructions>

# kosli get artifact

> Get artifact from a specified flow

## Synopsis

```shell theme={"theme":"dracula","languages":{"custom":["/languages/rego.json"]}}
kosli get artifact EXPRESSION [flags]
```

Get artifact from a specified flow
You can get an artifact by its fingerprint or by its git commit sha.
In case of using the git commit, it is possible to get multiple artifacts matching the git commit.

The expected argument is an expression to specify the artifact to get.
It has the format `FLOW_NAME``SEPARATOR``COMMIT_SHA1|ARTIFACT_FINGERPRINT`

Expression can be specified as follows:

* flowName@`fingerprint`  artifact with a given fingerprint. The fingerprint can be short or complete.
* flowName:`commit_sha`   artifact with a given commit SHA. The commit sha can be short or complete.

Examples of valid expressions are:

* flow\@184c799cd551dd1d8d5c5f9a5d593b2e931f5e36122ee5c793c1d08a19839cc0
* flow\@184c7
* flow:110d048bf1fce72ba546cbafc4427fb21b958dee
* flow:110d0

## Flags

| Flag                | Description                                                                                 |
| :------------------ | :------------------------------------------------------------------------------------------ |
| -h, --help          | help for artifact                                                                           |
| -o, --output string | \[defaulted] The format of the output. Valid formats are: \[table, json]. (default "table") |
| -t, --trail string  | \[optional] The Kosli trail name.                                                           |

## 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. A boolean flag [docs](/faq/#boolean-flags) (default false)          |
| -H, --host string         | \[defaulted] The Kosli endpoint. (default "[https://app.kosli.com](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.                                                                                     |

## Examples Use Cases

These examples all assume that the flags  `--api-token`, `--org`, `--host`, (and `--flow`, `--trail` when required), are [set/provided](/getting_started/install/#assigning-flags-via-environment-variables).

<AccordionGroup>
  <Accordion title="get an artifact with a given fingerprint from a flow">
    ```shell theme={"theme":"dracula","languages":{"custom":["/languages/rego.json"]}}
    kosli get artifact flowName@fingerprint

    ```
  </Accordion>

  <Accordion title="get the latest artifact with a given fingerprint from a flow in a specific trail">
    ```shell theme={"theme":"dracula","languages":{"custom":["/languages/rego.json"]}}
    kosli get artifact flowName@fingerprint

    ```
  </Accordion>

  <Accordion title="get an artifact with a given commit SHA from a flow">
    ```shell theme={"theme":"dracula","languages":{"custom":["/languages/rego.json"]}}
    kosli get artifact flowName:commitSHA

    ```
  </Accordion>

  <Accordion title="get a list of artifacts with a given commit SHA from a flow in a particular trail">
    ```shell theme={"theme":"dracula","languages":{"custom":["/languages/rego.json"]}}
    kosli get artifact flowName:commitSHA
    ```
  </Accordion>
</AccordionGroup>