artifact

The artifact command is used to download specific artifacts by their unique ID.

Usage

bytesalt artifact [artifact-id]

Arguments

• [artifact-id] (required): The unique identifier of the artifact you want to download.

Options

• --output \u003cpath\u003e: Specify the destination path for the downloaded artifact.
  • Can be a direct path: --output myfile.json
  • Or use the dest= prefix: --output dest=myfile.json
  • Default: If not specified, the filename is automatically extracted from the artifact URL.

Description

The artifact command downloads individual artifacts generated during test job execution. Artifacts can include:

• Screenshots
• Logs and other test outputs

The command automatically determines the filename from the artifact URL, matching the behavior of the web application’s download functionality. If the filename cannot be determined, you must specify a destination using the --output flag.

Example

# Download artifact with automatic filename
bytesalt artifact 7e9d3135-991e-4ac1-bf0c-6c5f0e98ad2a
 
# Download artifact to a specific location
bytesalt artifact 7e9d3135-991e-4ac1-bf0c-6c5f0e98ad2a --output report.json
 
# Download artifact with dest= prefix
bytesalt artifact 7e9d3135-991e-4ac1-bf0c-6c5f0e98ad2a --output dest=./reports/full-report.json

Finding Artifact IDs

Artifact IDs can be found in several places:

• Markdown/PDF Reports: Artifact links contain the ID in the URL (e.g., https://bytesalt.com/artifacts/7e9d3135-991e-4ac1-bf0c-6c5f0e98ad2a)
• JSON Reports: The artifact_ids array fields

Notes

• Artifact IDs are UUID format (e.g., 7e9d3135-991e-4ac1-bf0c-6c5f0e98ad2a)
• The command will fail with a clear error if the filename cannot be determined and no --output path is provided
• Downloaded files retain their original extensions when auto-detected from the URL