githubEdit

List

List recent test uploads for your organisation.

dcd list [flags]

Flags

Flag
Default
Description

--limit <n>

20

Maximum number of uploads to return

--offset <n>

0

Number of uploads to skip (for pagination)

--name <pattern>

Filter by upload name. Supports * as a wildcard — always quote wildcards to prevent shell expansion

--from <date>

Return uploads created on or after this date (ISO 8601, e.g. 2024-01-01)

--to <date>

Return uploads created on or before this date (ISO 8601)

--api-key <key>

Your DeviceCloud API key. Defaults to DEVICE_CLOUD_API_KEY env var

--json

Output results as JSON

Examples

# List the 20 most recent uploads
dcd list

# List with a wildcard name filter (note the quotes)
dcd list --name "nightly-*"

# Filter by date range
dcd list --from 2024-01-01 --to 2024-01-31

# Paginate
dcd list --limit 10 --offset 20

# JSON output
dcd list --json
circle-info

Always quote wildcard patterns to prevent your shell from expanding them before they reach the CLI — use "nightly-*" not nightly-*.

Output

Last updated