list
What is in a folder: each name beside the ID that names it
Reads only.
What is in a folder: each name beside the ID that names it.
Expects nothing and changes nothing. Each row carries the item's ID, name, kind, revision, the access you hold on it and who last changed it, so a listing is where the revision for a later change is read. recursive reaches everything beneath the folder, not only its own children. A folder's subtree_revision is deliberately not here: only stat and link answer that.
This answers one page at a time and carries a cursor when there is more, null when that was the whole of it. Pass the cursor back as cursor until it comes back null: a page is not the whole folder, so never conclude from one page that something is not there.
Arguments
| Argument | Type | Required | Meaning |
|---|---|---|---|
folder_id | text | yes | The folder to list |
recursive | flag | no | Everything beneath it, not only its own children |
limit | count | no | How many items this page may hold |
cursor | text | no | Continue from the cursor a previous page reported |
On the command line
flie agent list FOLDER_ID [--recursive] [--limit N] [--cursor C]flie --json agent list FOLDER_ID [--recursive] [--limit N] [--cursor C] # children, one page
# each row carries modified_by: who last changed it