List and filter tasks from the workspace task dashboard.
Returns a structured JSON object containing tasks and the IDs of referenced
objects (users, clients, projects, labels) that can be fetched separately.
Args:
workspace_id: Workspace slug (required).
ids: Fetch specific tasks by ID, bypassing the dashboard query.
Mutually exclusive with all filter parameters.
fields: Fields to request from the fetch API.
If omitted, defaults to id, name, workflow_state,
is_important, due_date, client_id, project_id.
Available fields:
id, name, workflow_state, is_important, is_private,
is_bookmarked, is_viewed, is_fixed_price, created,
due_date, fuzzy_due_date, snoozed_until_date,
assigned_to_id, creator_id, on_behalf_of_id,
client_id, project_id, label_ids, follower_ids,
checklist_item_ids, checklist_items_completed,
checklist_items_total, comment_ids, attachment_ids,
time_entry_ids, dependent_task_ids, depends_on_id,
time_budget, total_duration, has_billed_time_entries,
series_id, rrule, details, blocks.
limit: Maximum number of tasks to return (default: 50).
search: Free-text search query.
user_mode: Scope of tasks to include. One of: assigned, created, following,
interacted, personal (default: assigned). Determines the exact
meaning of the user_id parameter; e.g. `created` returns tasks
created by the user, `assigned` returns tasks assigned to the user.
user_id: Filter tasks by a specific user ID.
client_id: Filter tasks by a specific client ID.
project_id: Filter tasks by a specific project ID.
label_id: Filter tasks by a specific label ID.
by_time: Filter by time bucket, e.g. 'today' or 'week'.
only: Return tasks from a single dashboard section only. One of:
active, completed, overdue, important, unread, snoozed.
When omitted, tasks from all sections are merged in priority order.
bookmarked: Return only bookmarked tasks (default: False).
todo_sort: Sort order for active tasks. One of: manual, last_modified
(default: manual).
recent: If True, fetch recently interacted tasks,
ordered by most-recent interaction first.
Supports search, client_id, project_id, and limit;
other filter params (mode, user_id, label_id, by_time,
only, bookmarked) are not applicable and ignored.
An `action` field is added to every returned task
regardless of the fields requested (e.g. 'logged time',
'VIEWED', or None for catch-all entries).
Mutually exclusive with ids.