# workflows versions files

## Synopsis

<pre class="language-bash"><code class="lang-bash">omics workbench workflows versions files --workflow=WORKFLOW_ID [VERSION_ID]
<strong>  [--path=PATH]
</strong>  [--output=PATH]
  [--zip]
</code></pre>

## Description

Retrieve files belonging to a workflow version using the provided `WORKFLOW_ID` and `VERSION_ID` parameters. Behaviour depends on the values set for the flags. See the examples below for more information.

## Examples

Prints out the workflow's descriptor file to the screen:

```bash
omics workbench workflows versions files --workflow=12345678910 1.0.0
```

Prints the workflow file matching the given path to the screen. If the file is binary, the file contents will not be printed to the screen and a warning will be printed instead:

```bash
omics workbench workflows versions files --workflow=12345678910 1.0.0 \
  --path=my/path/file.wdl
```

Saves the content from the `--path` file as a file in the location specified by `--output`:

```bash
omics workbench workflows versions files --workflow=12345678910 1.0.0 \
  --path=my/path/file.wdl
  --output=output/new_file.txt
```

Saves all the workflow's files in the same hierarchy in the location specified by `--output`. Note: `--output` must end with a folder in order to store all the workflow's files:

```bash
omics workbench workflows versions files --workflow=12345678910 1.0.0 \
  --output=output/folder
```

Downloads the file specified by `--path` as a zip file in the location specified by `--output`:

```bash
omics workbench workflows versions files --workflow=12345678910 1.0.0 \
  --path=my/path/file.wdl
  --output=output/new_file.zip
  --zip
```

Downloads the file specified by `--path` as a zip file named `12345678910-1.0.0-files.zip` (`{workflow_name}-{workflow_version}-files.zip`) in the folder location specified by `--output`:

```bash
omics workbench workflows versions files --workflow=12345678910 1.0.0 \
  --path=my/path/file.wdl
  --output=output/folder
  --zip
```

Downloads the file specified by `--path` as a zip file named `12345678910-1.0.0-files.zip` in the current working directory:

```bash
omics workbench workflows versions files --workflow=12345678910 1.0.0 \
  --path=my/path/file.wdl
  --zip
```

Downloads all files in the workflow in the zip file location specified by `--output`:

```bash
omics workbench workflows versions files --workflow=12345678910 1.0.0 \
  --output=output/all_files.zip
  --zip
```

Downloads all files in the workflow as a zip file named `12345678910-1.0.0-files.zip`in the folder location specified by `--output`:

```bash
omics workbench workflows versions files --workflow=12345678910 1.0.0 \
  --output=output/all_files
  --zip
```

Downloads all files in the workflow as a zip file named `12345678910-1.0.0-files.zip` in the current working directory:

```bash
omics workbench workflows versions files --workflow=12345678910 1.0.0 \
  --zip
```

## Positional Arguments

### `VERSION_ID`

**Required**. Specify a version identifier (`VERSION_ID`) to retrieve the files corresponding to the workflow's specific version.

## Flags

### `--workflow`=`WORKFLOW_ID`

**Required**. Specify the UUID of the workflow for which you want to describe versions.

### `--path`=`PATH`

The path for the specific file in the workflow that is to be printed to the screen or downloaded.

### `--output`=`PATH`

The location where a workflow file or files will be downloaded. Note: if `--path` is not specified (i.e. you are downloading multiple files) then `--output` must end with a folder and not an existing file name.

### `--zip`

If specified, the file(s) will be downloaded as into a zip file. Note: if `--output` is not specified or does not end with a zip file, then it will create a zip file with the naming convention `{workflow_name}-{workflow_version}-files.zip`.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.omics.ai/products/command-line-interface/reference/workbench/workflows-versions-files.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.