Docs
Open Lodol
DocumentationIntegrationsAPI

Asana

App · Project Management · 7 actions

Create, update, and manage tasks, subtasks, comments, and followers in Asana.

Actions

ActionWhat it does
Add a commentAdd a comment (story) to an Asana task.
Add followersAdd one or more followers to an Asana task.
Create a subtaskCreate a subtask under an existing Asana task.
Create a taskCreate a new Asana task in a workspace, and optionally in one or more of its projects.
Delete a taskDelete an Asana task by its task ID.
Get a taskGet the full details of an Asana task by its task ID.
Update a taskUpdate fields on an existing Asana task, such as its name, description, assignee, due date, or completion status.

Add a comment

Add a comment (story) to an Asana task.

Inputs

Task IDtask_gidtextRequired
The ID (gid) of the task to comment on.
CommenttexttextRequired
The plain-text comment to add.

Outputs

Asana story (comment) object.

created_attext
created_byobject
gidtext
The comment's unique ID.
resource_subtypetext
texttext
typetext
Example output
{
  "created_by": {
    "gid": "1200000000001",
    "name": "Alex Kim"
  },
  "gid": "1300000000001",
  "resource_subtype": "comment_added",
  "text": "Looks good, approved to proceed."
}

Add followers

Add one or more followers to an Asana task. Followers get notified about changes to the task.

Inputs

Task IDtask_gidtextRequired
The ID (gid) of the task to add followers to.
FollowersfollowerstextRequired
Comma-separated list of users to add as followers. Each can be a user ID, an email, or the word 'me'.

Outputs

Asana task object.

assigneeobject
completedtrue/false
completed_attext
created_attext
due_attext
due_ontext
followerslist
gidtext
The task's unique ID.
modified_attext
nametext
notestext
num_subtasksnumber
parentobject
permalink_urltext
projectslist
resource_subtypetext
start_ontext
workspaceobject
Example output
{
  "followers": [
    {
      "gid": "1200000000001",
      "name": "Alex Kim"
    },
    {
      "gid": "1200000000002",
      "name": "Jordan Lee"
    }
  ],
  "gid": "1201234567890",
  "name": "Review Q3 budget"
}

Create a subtask

Create a subtask under an existing Asana task.

Inputs

Parent task IDparent_task_gidtextRequired
The ID (gid) of the task the subtask belongs to.
Subtask namenametextRequired
The title of the subtask.
Descriptionnotestext
The subtask description / notes.
Assigneeassigneetext
The user to assign the subtask to: a user ID, an email, or the word 'me'.
Due datedue_ondate
The day the subtask is due, in YYYY-MM-DD format.

Outputs

Asana task object.

assigneeobject
completedtrue/false
completed_attext
created_attext
due_attext
due_ontext
gidtext
The task's unique ID.
modified_attext
nametext
notestext
num_subtasksnumber
parentobject
permalink_urltext
projectslist
resource_subtypetext
start_ontext
workspaceobject
Example output
{
  "completed": false,
  "gid": "1209876543210",
  "name": "Collect stakeholder feedback",
  "parent": {
    "gid": "1201234567890",
    "name": "Review Q3 budget"
  },
  "permalink_url": "https://app.asana.com/0/0/1209876543210"
}

Create a task

Create a new Asana task in a workspace, and optionally in one or more of its projects.

Inputs

Task namenametextRequired
The title of the task, for example, Review Q3 budget.
WorkspaceworkspacetextRequired
The workspace to create the task in.
Projectsprojectslist
Projects to add the task to. Pick a workspace first to load its projects.
Descriptionnotestext
The task description / notes.
Assigneeassigneetext
The workspace member to assign the task to. Pick a workspace first to load its members.
Due datedue_ondate
The day the task is due, in YYYY-MM-DD format.

Outputs

Asana task object.

assigneeobject
completedtrue/false
completed_attext
created_attext
due_attext
due_ontext
gidtext
The task's unique ID.
modified_attext
nametext
notestext
num_subtasksnumber
parentobject
permalink_urltext
projectslist
resource_subtypetext
start_ontext
workspaceobject
Example output
{
  "completed": false,
  "due_on": "2024-06-15",
  "gid": "1201234567890",
  "name": "Review Q3 budget",
  "permalink_url": "https://app.asana.com/0/0/1201234567890"
}

Delete a task

Delete an Asana task by its task ID.

Inputs

Task IDtask_gidtextRequired
The ID (gid) of the task to delete.

Outputs

deletedtrue/false
gidtext
Example output
{
  "deleted": true,
  "gid": "1201234567890"
}

Get a task

Get the full details of an Asana task by its task ID.

Inputs

Task IDtask_gidtextRequired
The ID (gid) of the task to fetch.

Outputs

Asana task object.

assigneeobject
completedtrue/false
completed_attext
created_attext
due_attext
due_ontext
gidtext
The task's unique ID.
modified_attext
nametext
notestext
num_subtasksnumber
parentobject
permalink_urltext
projectslist
resource_subtypetext
start_ontext
workspaceobject
Example output
{
  "assignee": {
    "gid": "1200000000001",
    "name": "Alex Kim"
  },
  "completed": false,
  "due_on": "2024-06-01",
  "gid": "1201234567890",
  "name": "Draft launch plan",
  "notes": "Outline the Q3 launch steps.",
  "permalink_url": "https://app.asana.com/0/0/1201234567890"
}

Update a task

Update fields on an existing Asana task, such as its name, description, assignee, due date, or completion status.

Inputs

Task IDtask_gidtextRequired
The ID (gid) of the task to update.
Task namenametext
A new title for the task.
Descriptionnotestext
A new description / notes for the task.
Assigneeassigneetext
Reassign the task to a user ID, an email, or the word 'me'.
Due datedue_ondate
A new due date, in YYYY-MM-DD format.
Completedcompletedtrue/false
Set to true to mark the task complete, false to reopen it.

Outputs

Asana task object.

assigneeobject
completedtrue/false
completed_attext
created_attext
due_attext
due_ontext
gidtext
The task's unique ID.
modified_attext
nametext
notestext
num_subtasksnumber
parentobject
permalink_urltext
projectslist
resource_subtypetext
start_ontext
workspaceobject
Example output
{
  "completed": true,
  "due_on": "2024-06-20",
  "gid": "1201234567890",
  "name": "Review Q3 budget (revised)",
  "permalink_url": "https://app.asana.com/0/0/1201234567890"
}

arXiv

Previous Page

AssemblyAI

Next Page

On this page

ActionsAdd a commentAdd followersCreate a subtaskCreate a taskDelete a taskGet a taskUpdate a task