# Retrieve an issue

## Retrieve an issue

At some point it might be a good idea to keep a local copy of the errata information hosted within the errata system. The `retrieve` command has been designed in the aim of either downloading a specific issue files, a set of specific issues, or the whole lot of issues hosted within the errata system (for archiving purposes for example).

### Requirements

The command takes as arguments a list of UIDs, the JSON file directory and the dataset list file directory the user wishes to use. If `ESDOC_HOME` environment variable is declared in user’s environment a specific download directory will then be used otherwise, the client uses its own installation directory.

Note

If no UIDs are submitted, all issues are expected.

Note

If no directory is provided, a default directory will be used.

### Retrieve the issue

In order to download the issue with IDs `xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx`:

```
$> esgissue retrieve --issue esgissue/samples/downloads --dsets esgissue/samples/downloads --id xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
```

Note

The naming convention used in creating the issue related files is `issue_<UID>.json` and `dset_<UID>.txt`. If needed we could have specified `.json` and `.txt` file in this example since we are downloading a single issue.

Note

Multiple downloads are allowed by listing IDs next to the flag.


---

# 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://ipsl.gitbook.io/esgf-errata-service/errata-service-command-line-client/retrieve-an-issue.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.