gcai folders CLI commands

`gcai folders list`

List folders

gcai folders list [--limit <number>] [--offset <number>] [--q <value>] [--scope <my-files|shared-with-me|organization>]

Flag	Type	Description
`--limit <number>`	`number`	Max items to return (default 100, max 500)
`--offset <number>`	`number`	Number of items to skip (default 0)
`--q <value>`	`string`	Case-insensitive substring search on folder name or description. System-owned collection types (my-files, org-files, etc.) are excluded from results. Composes with `scope`.
`--scope <my-files\|shared-with-me\|organization>`	`my-files \| shared-with-me \| organization`	Filter folders to a single meta-collection. Requires a user-scoped API key.

Wraps GET /folders — see List folders for full parameter semantics.

Create a folder

gcai folders create <name> [--description <value>] [--parent-folder-id <value>] [--scope <my-files|organization>]

Flag	Type	Description
`--description <value>`	`string`	Optional description
`--parent-folder-id <value>`	`string`	Parent folder ID. Mutually exclusive with `scope`. If both are omitted, creates a top-level folder.
`--scope <my-files\|organization>`	`my-files \| organization`	Create the folder at the root of a meta-collection. Mutually exclusive with `parent_folder_id`. `shared-with-me` is not valid for create.

Wraps POST /folders — see Create a folder for full parameter semantics.

Get a folder

gcai folders get <id>

Wraps GET /folders/{id} — see Get a folder for full parameter semantics.

Update a folder

gcai folders update <id> [--name <value>] [--description <value>] [--parent-folder-id <value>] [--is-access-controlled]

Flag	Type	Description
`--name <value>`	`string`	New folder name (minimum 2 characters)
`--description <value>`	`string`	New folder description
`--parent-folder-id <value>`	`string`	Target parent folder ID. The destination must not be the folder itself or one of its descendants.
`--is-access-controlled`	`boolean`	Whether the folder requires explicit access grants

Wraps PATCH /folders/{id} — see Update a folder for full parameter semantics.

Delete a folder

gcai folders delete <id> [--recursive <true|false>]

Flag	Type	Required	Description
`--recursive <true\|false>`	`true \| false`		When `true`, recursively delete subfolders and files. Defaults to `false`.

Wraps DELETE /folders/{id} — see Delete a folder for full parameter semantics.

List a folder’s children

gcai folders children <id>

Wraps GET /folders/{id}/children — see List a folder’s children for full parameter semantics.