---
title: "Download an artifact file from the underlying container."
method: GET
path: "/artifacts"
---

# Download an artifact file from the underlying container.

`GET /artifacts`

## Request

- Base URL: `https://api.sandbox-gameye.gameye.net`
- URL: `https://api.sandbox-gameye.gameye.net/artifacts`
- Auth: HTTP bearer

Initiates a download of an artifact which could be a file or a folder inside the underlying
container. The path should be an absolute Unix path to a specific file or folder.

The artifact will be provided in the form of a .tar.gz archive that contains your requested
file or folder. Please limit your download in size to a maximum of 100mb.

Please note that the artifact is only available for download after the session has been
terminated and will be downloaded directly from the container itself.

The artifacts are available for download from the underlying container up until the 
container is removed from its host machine. This means that your logs may or 
may not be available post-termination.

## Query parameters

- `session` string, required
- `path` string, required

## Response `200`

A download of the artifact in .tar.gz format has been initiated.

## Other responses

- `401`: You are not authorized to fetch an artifact. Please make sure that the included bearer token is correct.
- `403`: Your API token may not have the required permissions to invoke this endpoint.
- `404`: Could not find a session with the given session id. It is possible that either the session has never existed at all or the container's lifespan on the machine has expired.

---

[API](https://skmtc.dev/gameye/apis/gameye-session-api.md) · [All operations](https://skmtc.dev/gameye/apis/gameye-session-api/llms.txt) · [OpenAPI document](https://skmtc.dev/gameye/apis/gameye-session-api/revisions/e6f57f399b73?raw)