Skip to main content

signaloid-cli tasks list

List all tasks.

Synopsis​

signaloid-cli tasks list [options]

Options​

OptionDescription
--status <status>Filter by status
--from <iso>From timestamp (ISO 8601)
--to <iso>To timestamp (ISO 8601)
--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>Tasks 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

Description​

Retrieves a list of all tasks in your account. You can filter by status, time range, and limit the number of results returned. Results are returned in reverse chronological order (newest first).

Examples​

List all tasks:

signaloid-cli tasks list

Filter by status:

signaloid-cli tasks list --status Completed

Filter by date range:

signaloid-cli tasks list \
  --from 2025-01-01T00:00:00Z \
  --to 2025-01-31T23:59:59Z

Limit results:

signaloid-cli tasks list --count 10

Get latest task:

signaloid-cli tasks list --count 1 --format json | jq -r '.Tasks[0].TaskID'

Output as table with custom columns:

signaloid-cli tasks list --columns id,status,created

Show available columns:

signaloid-cli tasks list --columns help

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.
  • Valid status values: Accepted, Initialising, Rescheduled, In Progress, Completed, Cancelled, Stopped
  • Timestamps must be in ISO 8601 format (e.g., 2025-01-13T12:00:00Z)

See Also​

Last updated on