Skip to main content
Manage and upload assets.

​
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: 
ANDROID
- momentic: 3 tags (latest 1.2.0)
- other: 1 tag (latest v1)
IOS
- momentic: 1 tag (latest 2.0.0)
With --channel <channel>, prints the newest-first tags for that channel under each platform heading: 
ANDROID
- momentic:
  - 1.2.0
  - 1.1.0
  - 1.0.0
IOS
- momentic:
  - 2.0.0
With --platform <platform>, only the requested platform is shown. 
npx momentic-mobile assets list [--channel <channel>] [--platform <platform>] [--tag-filter <tagFilter>] [--json]

​
Options

​
--channel <channel>
string
Channel to show tags for. When omitted, the command prints the channel summary view instead of tags.
​
--platform <platform>
string
Filter results to a specific mobile platform. One of android or ios.
​
--tag-filter <tagFilter>
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.
​
--json
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:
{
  "platforms": [
    {
      "platform": "ANDROID",
      "channels": [
        {
          "channel": "momentic",
          "tagCount": 3,
          "latestTag": "1.2.0",
          "latestUploadedAt": "2026-04-20T17:53:07.049Z"
        }
      ]
    },
    {
      "platform": "IOS",
      "channels": [
        {
          "channel": "momentic",
          "tagCount": 1,
          "latestTag": "2.0.0",
          "latestUploadedAt": "2026-04-08T23:37:20.541Z"
        }
      ]
    }
  ]
}
Tag list mode (with --channel <channel>) returns the channel name and a platforms array whose tags are ordered newest-first:
{
  "channel": "momentic",
  "platforms": [
    {
      "platform": "ANDROID",
      "tags": [
        {
          "tag": "1.2.0",
          "md5": "qrNr9GyYYmx4P6+ZwLcooQ==",
          "uploadedAt": "2026-04-20T17:53:07.049Z"
        },
        {
          "tag": "1.1.0",
          "md5": "oE9fZ8whKPWXbyaFWDM4BA==",
          "uploadedAt": "2026-04-01T12:00:00.000Z"
        }
      ]
    }
  ]
}

​
upload

Upload an APK asset to Momentic dashboard. After upload, the asset can be used in both the interactive editor and in test runs. The file provided must exist on disk and be an Android APK (.apk). 
npx momentic-mobile assets upload <file> --channel <channel> [--tag <tag>]

​
Arguments

​
<file>
string
required
Path to the APK file to upload. Must exist on disk and end in .apk.

​
Options

​
--channel <channel>
string
Required. Release channel for the asset, such as staging or dev. This name affects how the APK will be referenced by tests. Channels cannot be renamed after creation.
​
--tag <tag>
string
Version label within the channel. Can be a semantic version like 0.0.1 or a floating tag like latest. If omitted, defaults to latest.

​
download

Download a mobile asset (APK) from Momentic dashboard to the local machine. 
npx momentic-mobile assets download [path] --channel <channel> --tag <tag>

​
Arguments

​
[path]
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

​
--channel <channel>
string
Required. Release channel for the asset to download.
​
--tag <tag>
string
Required. Version label within the channel to download.