gum logofield manual
ServicesTasksGoogle APIs for agents and terminals

Tasks

Tasks has 12 operations in gum's generated catalog. Start with search when you know the task, use describe to inspect request fields and scopes, then dispatch through the command that matches the operation risk class.

Count Value
Family Workspace communication
Operations 12
Risk classes 2 destructive, 4 read, 6 write
Auth strategies 12 byo_oauth

Start here

bash
gum search "tasks"
gum describe tasks.tasklists.get
gum read tasks.tasklists.get --args '{"tasklist":"<tasklist>"}' --output json

For write-class operations, gum requires the write command and an explicit write gate:

bash
gum describe tasks.tasklists.insert
gum write tasks.tasklists.insert --allow-write --args '{"title":"<title>"}'

For destructive operations, run the call once for a confirmation envelope, review the target, then retry with the returned token:

bash
gum destructive tasks.tasklists.delete --args '{"tasklist":"<tasklist>"}'
gum destructive tasks.tasklists.delete --args '{"tasklist":"<tasklist>"}' --confirmed --token '<confirmation_token>'

Operations

Operation Risk Auth Summary
tasks.tasklists.delete destructive byo_oauth Delete a task list and all its tasks. Destructive — requires confirmation per §6.1.
tasks.tasklists.get read byo_oauth Fetch a task list by id.
tasks.tasklists.insert write byo_oauth Create a new task list (args.body: title).
tasks.tasklists.list read byo_oauth List the authenticated user's task lists.
tasks.tasklists.update write byo_oauth Rename a task list (args.body: title).
tasks.tasks.clear write byo_oauth Clear all completed tasks from a task list (they become hidden).
tasks.tasks.delete destructive byo_oauth Delete a task from a task list. Destructive — requires confirmation per §6.1.
tasks.tasks.get read byo_oauth Fetch a single task by id.
tasks.tasks.insert write byo_oauth Create a new task on the specified task list (args.body: title, notes, due, etc.).
tasks.tasks.list read byo_oauth List tasks in the specified task list.
tasks.tasks.move write byo_oauth Move a task to another position or parent within its list (reorder / nest).
tasks.tasks.update write byo_oauth Update a task (mark complete via status=completed, edit title/notes/due).

Next