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

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
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
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

opt_fields
array
opt_pretty
boolean
workspace_gid
stringRequired

Action Response

data
object
error
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
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
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
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
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
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
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

Action Response

data
object
error
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
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
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
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
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
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
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
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
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
successful
boolean