Skip to main content
Manage dashboard-hosted mobile assets (APKs and .app bundles). Each asset lives under a release channel (e.g. staging, dev) and is identified by a version tag.

list

List available asset channels and tags for your organization, grouped by platform. Without any flags, prints a summary of every channel under each platform heading with its tag count and latest uploaded tag:
With --channel <channel>, prints the newest-first tags for that channel under each platform heading:
With --platform <platform>, only the requested platform is shown.

Options

string
Channel to show tags for. When omitted, the command prints the channel summary view instead of tags.
string
Filter results to a specific mobile platform. One of android or ios.
string
Case-insensitive substring filter applied to tag names when listing a channel. For example, --tag-filter 1.2 matches any tag that contains the text 1.2.
boolean
Emit machine-readable JSON output instead of text.Summary mode (no --channel) returns a platforms array, each with its channels, tag counts, and the latest uploaded tag:
Tag list mode (with --channel <channel>) returns the channel name and a platforms array whose tags are ordered newest-first:

upload

Upload a mobile asset to the Momentic dashboard. After upload, the asset is available in both the interactive editor and in test runs. Supported formats: Android APK (.apk) and iOS .app directory (development build). See iOS app setup for building a testing-ready .app.
Uploaded assets are immutable: a (channel, tag) can only be re-uploaded with identical bytes. To publish a new build, upload it under a new tag (or delete the existing tag first). When --tag is omitted, a tag is generated for you and printed in the command output. A test that omits the tag, or uses the reserved tag latest, resolves to the most recently uploaded asset in the channel.

Arguments

string
required
Path to the asset to upload. Must be an .apk file or an .app directory.

Options

string
Required. Release channel for the asset, such as staging or dev. This name affects how the asset will be referenced by tests. Channels cannot be renamed after creation.
string
Version label within the channel, such as a semantic version like 0.0.1. When omitted, a tag is autogenerated and printed in the command output. latest is reserved and cannot be used as a tag; tests that reference latest (or omit the tag) resolve to the most recently uploaded asset in the channel.
string
Floating alias to repoint at this build, such as nightly or stable. Aliases are per-platform and move on each upload, while the underlying tagged bytes stay immutable, so a test referencing the alias always resolves to the most recently aliased asset. latest is reserved and cannot be used as an alias.

download

Download an APK from the Momentic dashboard to the local machine.

Arguments

string
Optional path to download the asset to. Can be a directory or a file path. If omitted, defaults to the current working directory. If a directory is provided, the file will be named <channel>-<tag>.apk.

Options

string
Required. Release channel for the asset to download.
string
Required. Version label within the channel to download.

delete

Delete a previously uploaded mobile asset. The command prompts for confirmation before deleting.

Options

string
required
Release channel of the asset to delete.
string
required
Version label of the asset to delete within the channel.
string
required
Platform of the asset to delete. One of android or ios.

Examples

List the most recent tags for the staging channel as JSON:
Upload a staging APK tagged 1.2.0:
Upload a build and repoint the nightly alias at it so tests referencing nightly resolve to this build:
Download a specific tag into the current directory:
Delete a specific asset: