Skip to main content

signaloid-cli builds list

List all builds.

Synopsis​

signaloid-cli builds list [options]

Options​

OptionDescription
--from <iso>Filter from timestamp (ISO 8601)
--to <iso>Filter to timestamp (ISO 8601)
--status <status>Filter by status
--cursor <cursor>Resume a listing from the Cursor value of the previous output, with the same filters
--start-key <key>Deprecated, use --cursor. Takes the ContinuationKey of the previous output.
--count <n>Number of items to fetch, across pages. With --status, each request reads a full page, so the output can hold more.
--limit <n>Builds per request, at most 25, or 500 with --summary (default: the maximum)
--summaryReturn summary rows instead of fully expanded objects
--format <type>Output format:json or table (default: json)
--columns <cols>Columns to display (comma-separated) or 'help' to see available columns

Status Values​

  • Accepted - Build accepted
  • Initialising - Build initializing
  • In Progress - Build in progress
  • Completed - Build completed successfully
  • Cancelled - Build canceled
  • Stopped - Build stopped
  • Rescheduled - Build rescheduled

Available Columns​

Default columns: id, status, type, isPublic, created

Available columns:

  • id - Build ID
  • status - Build status
  • type - Application type (shows Repository URL for repository builds)
  • typeDetails - Detailed application information (Repository or SourceCode fields as JSON)
  • isPublic - Whether the build is public (Yes/No)
  • created - Creation timestamp
  • updated - Last update timestamp
  • duration - Build duration
  • coreSpecs - Core specifications

Examples​

# List all builds (default columns)
signaloid-cli builds list

# List builds with custom columns
signaloid-cli builds list --columns id,status,type,isPublic,created

# Show available columns
signaloid-cli builds list --columns help

# Filter completed builds
signaloid-cli builds list --status Completed

# Filter by date range
signaloid-cli builds list \
  --from 2025-01-01T00:00:00Z \
  --to 2025-01-31T23:59:59Z

# Fetch specific number of results
signaloid-cli builds list --count 10

# Output as JSON
signaloid-cli builds list --format json

# Get latest build
signaloid-cli builds list --count 1 --format json | jq -r '.Builds[0].BuildID'

# Show detailed type information
signaloid-cli builds list --columns id,status,type,typeDetails

Notes​

  • Without --count, the command fetches one page. See Pagination.
  • With --status, the command fetches whole pages, because the status filter applies after a page is read, so the output can hold more items than --count.

See Also​

Last updated on