View as Markdown
Asana icon

Asana ACTION

Update Task

Updates one or more fields on an existing Asana task (name, assignee, due date, completion status, notes, custom fields, etc.). All fields are optional — supply only the ones you want to change; unchanged fields retain their current values. Use Find Task by ID or Search Tasks to obtain the task GID first. Returns the updated task record. Example: call with task_gid: '1202345678901234', completed: true → marks the task complete and returns the updated record. See the documentation
  • Action
  • Writes data
  • OAuth
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Asana account once, then configure and run Update Task from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "asana-update-task",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    asana: { authProvisionId: "apn_xxxxxxx" },
    workspace: "Workspace",
    project: "Project",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Update Task inputs
Property Type Description
workspace Workspace string
GID of the workspace, e.g. 1200123456789012. Use List Workspaces to find available workspace GIDs.
Required
project Project string
List of projects. This field uses the project GID (e.g. 1204567890123456). Use Search Projects to find available project GIDs (the gid field).
Required
task_gid Task GID string
The ID of the task to update
Required
name Name string
Name of the task. This is generally a short sentence fragment that fits on a line in the UI for maximum readability. However, it can be longer.
Optional
assignee Assignee string
Gid of a user. Use List Users to find available user GIDs.
Optional
assignee_section Assignee Section string
The assignee section is a subdivision of a project that groups tasks together in the assignee's "My Tasks" list (a section GID, e.g. 1203456789012345). Use Get Tasks From Task List with optFields including assignee_section to retrieve the authenticated user's own My Tasks section GIDs. GIDs for another assignee's sections must come from that person's own My Tasks list, not from this account.
Optional
completed Completed boolean
True if the task is currently marked complete, false if not.
Optional
due_at Due At string
The UTC date and time on which this task is due, or null if the task has no due time. This takes an ISO 8601 date string in UTC and should not be used together with due_on.
Optional
due_on Due On string
The localized date on which this task is due, or null if the task has no due date. This takes a date with YYYY-MM-DD format and should not be used together with due_at.
Optional
html_notes HTML Notes string
The notes of the text with formatting as HTML.
Optional
notes Notes string
Free-form textual information associated with the task (i.e. its description).
Optional
start_on Start On string
The day on which work begins for the task , or null if the task has no start date. This takes a date with YYYY-MM-DD format.
Optional
custom_fields Custom Fields string
An object where each key is a Custom Field gid and each value is an enum gid, string, or number: E.g. { "4578152156": "Not Started", "5678904321": "On Hold" }
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
asana-update-task
Version
0.4.9
App
Asana
Authentication
OAuth
Read-only
No
Destructive
No
Open world
Yes