Paging Items
When listing entities such as Workflows or Instances, the results may be paged. The --max-size
and --after
options can be used to control paging behavior.
Setting Page Size using --max-size
--max-size
--max-size
: Controls the number of items returned for a single query. Defaults to 25.
$ catalytic instance list --max-size 50
Setting Page Offset using --after
--after
Any command to list items that is truncated by paging limits will output a Next Page Token
value, which can be used as the --after
option in subsequent commands to view the next set of items.
--after
: Acts as a paging offset to reveal the next set of items in a list query.
$ catalytic instance list --max-size 50 --after 50
Finding Next Page Token
Next Page Token
JSON Formatted Output
$ catalytic workflow list --format json
{
"items": [...],
"nextPageToken": 25
}
CSV Formatted Output
$ catalytic workflow list --format "csv(Id,Name)"
Next Page Token: 25
Id, Name
10000000-0000-0000-0000-000000000000,My Workflow
...
Table Formatted Output
$ catalytic workflow list --format "table(Id,Name)"
Next Page Token: 25
# | Id | Name
----|--------------------------------------|---------------------
1 | 10000000-0000-0000-0000-000000000000 | My Workflow
...
Updated over 3 years ago