---
title: "ktm artifacts get"
description: "Use ktm artifacts get to download screenshots, logs, or traces by URL or relative path directly from the command line."
sidebarTitle: "get"
lastUpdated: "2026-09-23"
---

> **For AI agents:** the complete documentation index is at [llms.txt](/llms.txt). Append `.md` to any page URL for its markdown version.

{/* GENERATED FILE: do not edit by hand. Regenerate with: node scripts/generate.mjs */}

Download an artifact by URL or relative path

## Usage

```bash
ktm artifacts get [flags]
```

## Examples

```bash
# Fetch by full URL, save to file
ktm artifacts get --url https://app.kapptivate.com/robot/path/screenshot.png --output shot.png

# Fetch by relative path
ktm artifacts get --path path/screenshot.png --output shot.png

# Text artifact to stdout
ktm artifacts get --url https://app.kapptivate.com/robot/path/trace.xml
```

## Flags

| Flag | Type | Default | Description |
| --- | --- | --- | --- |
| `--max-size` | int | `5242880` | Maximum artifact size in bytes |
| `--output` | string |  | Output file path (required for binary artifacts) |
| `--path` | string |  | Relative artifact path (host prefix added automatically) |
| `--url` | string |  | Full artifact URL (mutually exclusive with --path) |

## Details

Fetch a test artifact (screenshot, audio, log, etc.) from the platform.

Provide either --url (full URL) or --path (relative path — host prefix added automatically).
Text artifacts are printed to stdout. Binary artifacts require --output to specify a file.

## Related

- [`ktm artifacts`](/cli/commands/artifacts)

<Note>
  Global flags (`--output`, `--debug`, `--host`, …) apply to every command. See the [command reference overview](/cli/commands/overview).
</Note>

## What's next?

<Columns cols={2}>
  <Card title="All commands" icon="terminal" href="/cli/commands/overview">
    Browse the full CLI reference.
  </Card>
  <Card title="Get started" icon="rocket" href="/cli/getting-started">
    Install the CLI and authenticate.
  </Card>
</Columns>