Asana

Learn how to use Asana with Composio

Overview

Enum

ASANA

Description

Tool to help teams organize, track, and manage their work.

Authentication Details

client_id
stringRequired
client_secret
stringRequired
oauth_redirect_uri
stringDefaults to https://backend.composio.dev/api/v1/auth-apps/add
scopes
string

Actions

Tool to add followers to a task in asana. use this tool when you need to add one or more users as followers to a specific task. this will notify them of updates to the task.

Action Parameters

followers
arrayRequired
opt_fields
array
opt_pretty
boolean
task_gid
stringRequired

Action Response

data
object
error
string
successful
boolean
Tool to add a supporting goal relationship to a goal. use when you want to link a project, task, portfolio, or another goal as a supporting resource to a specific goal in asana.

Action Parameters

data
objectRequired
goal_gid
stringRequired
opt_fields
array
opt_pretty
boolean

Action Response

data
object
error
string
successful
boolean
Adds an existing task to a section, optionally positioning it before or after another task in that section; if no position is specified, the task is added to the end.

Action Parameters

insert_after
string
insert_before
string
section_gid
stringRequired
task_gid
stringRequired

Action Response

data
object
error
string
successful
boolean
Creates a new allocation. use when you need to schedule or assign a specific amount of a user's time per week to a task or project within a defined period.

Action Parameters

assignee_gid
stringRequired
end_on
stringRequired
minutes_per_week
integerRequired
notes
string
project_gid
string
start_on
stringRequired
workspace_gid
stringRequired

Action Response

data
object
error
string
successful
boolean
Tool to upload an attachment to a task. use when you need to attach a file to a specific task in asana.

Action Parameters

connect_to_app
boolean
file_content
stringRequired
file_content_type
stringRequired
file_name
stringRequired
parent_gid
stringRequired
resource_subtype
string

Action Response

data
object
error
string
successful
boolean
Tool to create a new custom field in a workspace. use when you need to define a new field for tracking specific information within asana tasks.

Action Parameters

data
objectRequired
opt_fields
array
opt_pretty
boolean

Action Response

data
object
error
string
successful
boolean
Tool to create a new enum option for a custom field in asana. use this when you need to add a new selectable option to an existing custom field.

Action Parameters

custom_field_gid
stringRequired
data
objectRequired
opt_fields
array
opt_pretty
boolean

Action Response

data
object
error
string
successful
boolean
Tool to create a new status update on a project. use when you need to communicate the current status, progress, or any blockers related to a specific project.

Action Parameters

color
stringRequired
project_gid
stringRequired
status_type
stringRequired
text
stringRequired
title
stringRequired

Action Response

data
object
error
string
successful
boolean
Creates a new section in a project, optionally positioned relative to an existing section in the same project, and returns the full record of the new section.

Action Parameters

insert_after
string
insert_before
string
name
stringRequired
project_gid
stringRequired

Action Response

data
object
error
string
successful
boolean
Creates a new asana subtask under an existing parent task (`task gid`); `due on` and `due at` are mutually exclusive and cannot be set simultaneously.

Action Parameters

assignee
string
completed
boolean
due_at
string
due_on
string
followers
array
name
stringRequired
notes
string
task_gid
stringRequired

Action Response

data
object
error
string
successful
boolean
Adds a new text comment (story) to an existing asana task, appearing in its activity feed.

Action Parameters

task_id
stringRequired
text
stringRequired

Action Response

data
object
error
string
successful
boolean
Tool to delete an allocation by its id. use this when you need to remove a specific resource allocation in asana.

Action Parameters

allocation_gid
stringRequired
opt_pretty
boolean

Action Response

data
object
error
string
successful
boolean
Tool to delete an attachment by its globally unique identifier. use when you need to remove an existing attachment from asana.

Action Parameters

attachment_gid
stringRequired
opt_pretty
boolean

Action Response

data
object
error
string
successful
boolean
Tool to delete a custom field by its globally unique identifier. use when you need to remove an existing custom field from asana.

Action Parameters

custom_field_gid
stringRequired

Action Response

data
object
error
string
successful
boolean
Delete a project.

Action Parameters

opt_pretty
boolean
project_gid
stringRequired

Action Response

data
object
error
string
successful
boolean
Tool to delete a specific tag by its gid. use when you need to remove an existing tag from asana.

Action Parameters

opt_pretty
boolean
tag_gid
stringRequired

Action Response

data
object
error
string
successful
boolean
Delete a task.

Action Parameters

opt_pretty
boolean
task_gid
stringRequired

Action Response

data
object
error
string
successful
boolean
Duplicate a project.

Action Parameters

include
array
name
stringRequired
project_gid
stringRequired
schedule_dates
object
team
string

Action Response

data
object
error
string
successful
boolean
Duplicate a task

Action Parameters

include
array
name
string
task_gid
stringRequired

Action Response

data
object
error
string
successful
boolean
Get an allocation by id. use when you need to retrieve the details of a specific allocation.

Action Parameters

allocation_gid
stringRequired
opt_fields
array
opt_pretty
boolean

Action Response

data
object
error
string
successful
boolean
Tool to get multiple allocations. use when you need to retrieve a list of allocations, optionally filtered by project, user, or workspace.

Action Parameters

assignee
string
limit
integer
offset
string
opt_fields
array
opt_pretty
boolean
parent
string
workspace
string

Action Response

data
array
error
string
next_page
object
successful
boolean
Tool to get a single attachment by its globally unique identifier. use when you need to retrieve details about a specific file attached to a task or project.

Action Parameters

attachment_gid
stringRequired
opt_fields
string

Action Response

data
object
error
string
successful
boolean
Tool to get audit log events for a workspace. use when you need to retrieve a log of actions performed within a specific asana workspace.

Action Parameters

actor_gid
string
actor_type
string
end_at
string
event_type
string
limit
integer
offset
string
resource_gid
string
start_at
string
workspace_gid
stringRequired

Action Response

data
array
error
string
next_page
object
successful
boolean
Retrieves a specific asana project by its `project gid`, with an option to include additional fields for comprehensive details using `opt fields`; this action does not return tasks within the project.

Action Parameters

opt_fields
array
opt_pretty
boolean
project_gid
stringRequired

Action Response

data
object
error
string
successful
boolean
Retrieves full details for a specified task gid accessible by the user; use `opt fields` to customize returned data.

Action Parameters

opt_fields
array
opt_pretty
boolean
task_gid
stringRequired

Action Response

data
object
error
string
successful
boolean
Retrieves the authenticated user's full record, including accessible workspaces, often used as an initial call to establish user context for subsequent operations.

Action Parameters

Action Response

data
object
error
string
successful
boolean
Tool to get a single custom field by its globally unique identifier. use when you need to retrieve the complete metadata and properties of a specific custom field in asana.

Action Parameters

custom_field_gid
stringRequired
opt_fields
array
opt_pretty
boolean

Action Response

data
object
error
string
successful
boolean
Tool to get all custom fields in a workspace. use when you need to retrieve a list of custom fields associated with a specific workspace.

Action Parameters

limit
integer
offset
string
opt_fields
array
opt_pretty
boolean
workspace_gid
stringRequired

Action Response

data
array
error
string
next_page
object
successful
boolean
Retrieve events on a resource to monitor changes. use when you need to track activity or changes related to a specific asana resource like a task, project, or tag.

Action Parameters

opt_fields
array
opt_pretty
boolean
resource_gid
stringRequired
sync
string

Action Response

data
array
error
string
has_more
boolean
successful
boolean
sync
string
Retrieve the full record for a single goal by its gid.

Action Parameters

goal_gid
stringRequired
opt_fields
string

Action Response

data
object
error
string
successful
boolean
Tool to retrieve multiple goals. use when you need to get a list of goals, optionally filtered by workspace, team, portfolio, project, time period, or archived status.

Action Parameters

archived
boolean
is_workspace_level
boolean
limit
integer
offset
string
opt_fields
array
portfolio
string
project
string
team
string
time_period
string
workspace
string

Action Response

data
array
error
string
successful
boolean
Tool to retrieve goal relationships. use when you need to get the relationships associated with a specific goal in asana.

Action Parameters

goal_gid
stringRequired
limit
integer
offset
string
opt_fields
array
opt_pretty
boolean

Action Response

data
array
error
string
successful
boolean
Tool to retrieve memberships for goals, projects, portfolios, or custom fields. use this to find out who has access to a specific asana resource or what resources a specific user/team has access to.

Action Parameters

limit
integer
member
string
offset
string
opt_fields
string
parent
string

Action Response

data
array
error
string
next_page
object
successful
boolean
Retrieve the full record for a single portfolio by its gid. use this when you need to get detailed information about a specific portfolio.

Action Parameters

limit
integer
offset
string
opt_fields
array
opt_pretty
boolean
portfolio_gid
stringRequired

Action Response

data
object
error
string
successful
boolean
Retrieve multiple portfolios. use when you need to list portfolios within a specific workspace, optionally filtered by owner.

Action Parameters

limit
integer
offset
string
opt_fields
array
owner
string
workspace
stringRequired

Action Response

data
array
error
string
next_page
object
successful
boolean
Retrieve items in a portfolio. use this to get a list of projects or other portfolios contained within a specific portfolio.

Action Parameters

limit
integer
offset
string
opt_fields
array
portfolio_gid
stringRequired

Action Response

data
array
error
string
next_page
object
successful
boolean
Tool to retrieve multiple portfolio memberships. use this tool when you need to list memberships for a specific portfolio, a user within a portfolio, or a user across all portfolios in a workspace.

Action Parameters

limit
integerDefaults to 50
offset
string
opt_fields
array
portfolio
string
user
string
workspace
string

Action Response

data
array
error
string
next_page
object
successful
boolean
Tool to get a list of projects for a specific team in asana. use when you need to retrieve project details associated with a team.

Action Parameters

archived
boolean
limit
integer
offset
string
opt_fields
array
opt_pretty
boolean
team_gid
stringRequired

Action Response

data
array
error
string
next_page
object
successful
boolean
Tool to retrieve a project's brief. use when you need to get the detailed explanation (what and why) of a project.

Action Parameters

opt_fields
array
opt_pretty
boolean
project_brief_gid
stringRequired

Action Response

data
object
error
string
successful
boolean
Tool to retrieve memberships from a project. it can also be used to get memberships for a user across multiple projects or all projects in a workspace.

Action Parameters

limit
integerDefaults to 20
offset
string
opt_fields
array
opt_pretty
boolean
project
string
user
string
workspace
string

Action Response

data
array
error
string
next_page
object
successful
boolean
Tool to retrieve the full record for a single project status by its gid. use when you need to get the details of a specific project status update.

Action Parameters

opt_fields
array
opt_pretty
boolean
project_status_gid
stringRequired

Action Response

data
object
error
string
successful
boolean
Tool to get status updates for a specific project. use when you need to retrieve the latest or historical status reports associated with an asana project.

Action Parameters

limit
integerDefaults to 50
offset
string
opt_fields
array
opt_pretty
boolean
project_gid
stringRequired

Action Response

data
array
error
string
next_page
object
successful
boolean
Tool to retrieve multiple project templates. use when you need to list available project templates in a workspace or team.

Action Parameters

limit
integer
offset
string
opt_fields
array
team_gid
string
workspace_gid
string

Action Response

data
array
error
string
next_page
object
successful
boolean
Retrieve the full record for a single section by its gid. use this when you need to get details about a specific section within a project.

Action Parameters

opt_fields
array
opt_pretty
boolean
section_gid
stringRequired

Action Response

data
object
error
string
successful
boolean
Returns compact records for all sections (used to group tasks) in a specified project.

Action Parameters

limit
integer
offset
string
project_gid
stringRequired

Action Response

data
array
error
string
successful
boolean
Retrieve status updates from an object. use when you need to get the latest or historical status updates for a specific project, portfolio, or goal.

Action Parameters

limit
integer
offset
string
opt_fields
array
parent
stringRequired

Action Response

data
array
error
string
next_page
object
successful
boolean
Tool to get stories (comments, status updates, etc.) for a task. use when you need to retrieve the history or discussion associated with a specific task.

Action Parameters

limit
integer
offset
string
opt_fields
array
task_gid
stringRequired

Action Response

data
array
error
string
next_page
object
successful
boolean
Tool to retrieve a story. use when you need to get the complete record for a single story.

Action Parameters

opt_fields
array
opt_pretty
boolean
story_gid
stringRequired

Action Response

data
object
error
string
successful
boolean
Tool to get a single tag by its globally unique identifier. use when you need to retrieve detailed information about a specific tag.

Action Parameters

opt_fields
array
opt_pretty
boolean
tag_gid
stringRequired

Action Response

data
object
error
string
successful
boolean
Get multiple tags in a workspace.

Action Parameters

limit
integer
offset
string
opt_fields
array
workspace
string

Action Response

data
array
error
string
next_page
object
successful
boolean
Retrieves tasks from a specified asana project, allowing filtering by completion status and selection of optional fields for detailed responses.

Action Parameters

completed_since
string
limit
integer
offset
string
opt_fields
array
opt_pretty
boolean
project_gid
stringRequired

Action Response

data
object
error
string
successful
boolean
Tool to get the list of attachments for a given task, project, or project brief. use when you need to retrieve files attached to a specific asana object.

Action Parameters

limit
integerDefaults to 50
offset
string
opt_fields
array
parent_gid
stringRequired

Action Response

data
array
error
string
next_page
object
successful
boolean

Action Parameters

limit
integer
offset
string
opt_fields
array
task_gid
stringRequired

Action Response

data
array
error
string
next_page
object
successful
boolean
Tool to retrieve multiple task templates from a workspace. use when you need to list or find available task templates.

Action Parameters

limit
integer
offset
string
opt_fields
string
project_gid
string
workspace_gid
string

Action Response

data
array
error
string
next_page
object
successful
boolean
Returns the compact records for all teams in the workspace visible to the authorized user.

Action Parameters

limit
integer
offset
string
workspace_gid
stringRequired

Action Response

data
array
error
string
successful
boolean
Tool to retrieve compact team membership records. use when you need to list members of a team, teams a user belongs to, or all team memberships in a workspace.

Action Parameters

limit
integer
offset
string
opt_fields
array
opt_pretty
boolean
team
string
user
string
workspace
string

Action Response

data
array
error
string
successful
boolean
Tool to retrieve compact or full representations of time periods. use this when you need to fetch information about specific time periods, such as their start and end dates, display names, and parent periods.

Action Parameters

end_on
string
limit
integer
offset
string
opt_fields
array
opt_pretty
boolean
start_on
string
workspace_gid
stringRequired

Action Response

data
array
error
string
next_page
object
successful
boolean
Tool to retrieve objects in a workspace via a typeahead search algorithm. use when you need to quickly find objects like tasks, projects, users, etc., based on a search string. this is useful for implementing auto-completion features.

Action Parameters

count
integer
opt_fields
array
opt_pretty
boolean
query
string
resource_type
stringDefaults to user
workspace_gid
stringRequired

Action Response

data
array
error
string
successful
boolean
Get a user by their id.

Action Parameters

opt_fields
array
opt_pretty
boolean
user_gid
stringRequired

Action Response

data
object
error
string
successful
boolean
Get users in a team.

Action Parameters

limit
integer
offset
string
opt_fields
array
opt_pretty
boolean
team_gid
stringRequired

Action Response

data
array
error
string
next_page
object
successful
boolean
Get users in a workspace or organization.

Action Parameters

limit
integer
offset
string
opt_fields
array
opt_pretty
boolean
workspace_gid
stringRequired

Action Response

data
array
error
string
next_page
object
successful
boolean
Tool to retrieve the workspace memberships for a specific workspace. use when you need to list members of a workspace.

Action Parameters

limit
integer
offset
string
opt_fields
array
user
string
workspace_gid
stringRequired

Action Response

data
array
error
string
next_page
object
successful
boolean
Tool to retrieve the projects associated with a specific workspace. use when you need to list all projects within a given asana workspace.

Action Parameters

limit
integer
offset
string
opt_expand
array
opt_fields
array
workspace_gid
stringRequired

Action Response

data
array
error
string
next_page
object
successful
boolean
Tool to reorder an existing enum option or insert a new enum option for a custom field at a specific position. use when you need to manage the order of options in an enum custom field or add a new option at a defined place.

Action Parameters

custom_field_gid
stringRequired
data
objectRequired
opt_fields
array
opt_pretty
boolean

Action Response

data
object
error
string
successful
boolean
Tool to remove one or more followers from a task. use when you need to update the list of users following a specific task.

Action Parameters

followers
arrayRequired
task_gid
stringRequired

Action Response

data
object
error
string
successful
boolean
Tool to submit multiple asana api requests in parallel using the batch api. use when you need to perform several operations efficiently, such as fetching multiple tasks or creating multiple subtasks at once.

Action Parameters

data
objectRequired

Action Response

data
array
error
string
successful
boolean
Tool to update an existing allocation by its id. use this when you need to modify details like the start date, end date, effort, or assignee for an allocation.

Action Parameters

allocation_gid
stringRequired
data
objectRequired
opt_fields
array
opt_pretty
boolean

Action Response

data
object
error
string
successful
boolean
Tool to update a custom field by its globally unique identifier. use when you need to modify properties of an existing custom field in asana.

Action Parameters

custom_field_gid
stringRequired
data
objectRequired
opt_fields
array
opt_pretty
boolean

Action Response

data
object
error
string
successful
boolean
Tool to update an enum option for a custom field. use when you need to modify the name, color, or enabled status of an existing enum option.

Action Parameters

data
objectRequired
enum_option_gid
stringRequired
opt_fields
array
opt_pretty
boolean

Action Response

data
object
error
string
successful
boolean
Update a project.

Action Parameters

archived
boolean
color
string
custom_fields
object
default_view
string
due_date
string
due_on
string
html_notes
string
is_template
boolean
name
string
notes
string
owner
string
project_gid
stringRequired
public
boolean
start_on
string
team
string

Action Response

data
object
error
string
successful
boolean
Tool to update an existing tag by its globally unique identifier. use when you need to change the name or color of a tag.

Action Parameters

data
objectRequired
tag_gid
stringRequired

Action Response

data
object
error
string
successful
boolean
Creates a new asana project, requiring either a `workspace` or `team` gid for association, and returns the full project details.

Action Parameters

data
objectRequired
opt_fields
array
opt_pretty
boolean

Action Response

data
object
error
string
successful
boolean
Creates a new tag, with properties like name and color defined in the request body, within a specific asana workspace (using `workspace gid`); this tag helps categorize tasks, is confined to the workspace, and is not automatically applied to tasks.

Action Parameters

data
objectRequired
opt_fields
array
opt_pretty
boolean
workspace_gid
stringRequired

Action Response

data
object
error
string
successful
boolean
Creates a new asana task; requires 'workspace', 'parent', or 'projects' for association, and 'followers', 'projects', 'tags' are set only at creation.

Action Parameters

data
objectRequired
opt_fields
array
opt_pretty
booleanDefaults to True

Action Response

data
object
error
string
successful
boolean
Tool to create a new team in an asana workspace. use when you need to establish a new team for collaboration.

Action Parameters

data
objectRequired

Action Response

data
object
error
string
successful
boolean
Retrieves a specific user's task list from asana by its `user task list gid`, optionally returning extended details like name, owner, and workspace if specified in `opt fields`.

Action Parameters

opt_fields
array
opt_pretty
boolean
user_task_list_gid
stringRequired
workspace
stringRequired

Action Response

data
object
error
string
successful
boolean
Returns a list of projects, optionally filtered by workspace, team, or archived status, supporting pagination for large datasets.

Action Parameters

archived
boolean
limit
integer
offset
string
opt_fields
array
opt_pretty
boolean
team
string
workspace
string

Action Response

data
object
error
string
successful
boolean
Retrieves a list of tasks, allowing filtering by assignee (requires `workspace`), project, section, `completed since`, and `modified since`; `workspace` also requires `assignee`.

Action Parameters

assignee
string
completed_since
string
limit
integer
modified_since
string
offset
string
opt_fields
array
opt_pretty
boolean
project
string
section
string
workspace
string

Action Response

data
object
error
string
successful
boolean
Returns a list of users in an asana workspace or organization, optionally filtered by workspace or team gid, with support for pagination and specifying optional fields.

Action Parameters

limit
integer
offset
string
opt_fields
array
opt_pretty
boolean
team
string
workspace
string

Action Response

data
object
error
string
successful
boolean
Retrieves all workspaces accessible by the authenticated user, returning an empty list if the user has no accessible workspaces.

Action Parameters

limit
integer
offset
string
opt_fields
array
opt_pretty
boolean

Action Response

data
object
error
string
successful
boolean
Tool to retrieve details of a specific team by its gid. use when you need to fetch information about a particular team in asana.

Action Parameters

opt_fields
array
opt_pretty
boolean
team_gid
stringRequired

Action Response

data
object
error
string
successful
boolean
Tool to retrieve details of a specific workspace by its gid. use when you need to get information about a particular asana workspace.

Action Parameters

opt_fields
array
opt_pretty
boolean
workspace_gid
stringRequired

Action Response

data
object
error
string
successful
boolean
Updates attributes of an existing asana task identified by its task gid.

Action Parameters

data
objectRequired
opt_fields
array
opt_pretty
booleanDefaults to True
task_gid
stringRequired

Action Response

data
object
error
string
successful
boolean
Tool to update details of an existing team. use when you need to change a team's name, description, or organization.

Action Parameters

description
string
name
string
opt_fields
array
opt_pretty
boolean
organization
string
team_gid
stringRequired

Action Response

data
object
error
string
successful
boolean