Skip to main content
List artifacts in your workspace. artifact list finds stored artifacts. Filter the results by artifact namespace, labels, or a regular expression matching the artifact path.

Usage

Example

List artifacts whose paths begin with build-outputs/:

Options

—include_expired

Include expired entries in the results.

—labels <key=value>

Only return artifacts with these labels. Accepts a stringToString map of key-value pairs, such as --labels project=app,branch=main. Defaults to an empty map ([]).

—match_path_regex string

Only return artifacts whose path matches this regular expression.

—max_entries int32

Maximum number of artifacts to return, up to 10000. Defaults to 50.

—namespaces strings

Only return artifacts belonging to any of the specified namespaces.

—output, -o <format>

Output format. One of plain or json. Defaults to plain.
Last modified on October 26, 2026