Asana integration

Fetching task

Fetch a single Asana task by GID. Pass project_gid as a hint for scope validation when the connection covers multiple projects.

Fetching tasks

List tasks by one filter: project, section, tag or user_task_list. An assignee filter (assignee="me" for the current user) searches the connection's whole scope instead.

Fetching project tasks

List tasks in one project in scope. project_gid takes the project's gid or exact name. Pass completed_since="now" for open tasks only. For one person's tasks in a project use ASANA_SEARCH_TASKS_IN_WORKSPACE with projects_any and assignee_any.

Fetching section tasks

List tasks in a specific Asana section. Pass section_gid (looked up via ASANA_GET_SECTIONS_IN_PROJECT).

Searching tasks

Search tasks across every project this connection covers (or the projects in projects_any). Use it for 'my tasks' (assignee_any ['me']), open or overdue tasks, tasks due in a period, recently changed tasks, custom field filters and free text. Without text, sort_by=due_date gives a deadline overview.

Creating task

Updating task

Update an existing Asana task. Put only the fields the user wants to change inside `data`. To remove a value (due date, notes, assignee) list it in clear_fields instead.

Deleting task

Move an Asana task to the trash. Requires task_gid; the connection scope is enforced at runtime.

Duplicating task

Duplicate an Asana task. `include` controls which sub-resources are copied (notes, assignee, subtasks, attachments, ...).

Setting task parent

Move an Asana task under a new parent task. Pass `data: { parent: <task_gid> }` (or `null` to detach).

Fetching subtasks

List subtasks of an Asana task.

Creating subtask

Create a subtask under a parent Asana task. Assignee must be a numeric GID or 'me'.