Asana

Learn how to use Asana with Composio

Overview

SLUG: 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
bearer_token
string

Connecting to Asana

Create an auth config

Use the dashboard to create an auth config for the Asana toolkit. This allows you to connect multiple Asana accounts to Composio for agents to use.

1

Select App

Navigate to the Asana toolkit page and click “Setup Integration”.

2

Configure Auth Config Settings

Select among the supported auth schemes of and configure them here.

3

Create and Get auth config ID

Click “Create Integration”. After creation, copy the displayed ID starting with ac_. This is your auth config ID. This is not a sensitive ID — you can save it in environment variables or a database. This ID will be used to create connections to the toolkit for a given user.

Connect Your Account

Using OAuth2

1from composio import Composio
2from composio.types import auth_scheme
3
4# Replace these with your actual values
5asana_auth_config_id = "ac_YOUR_ASANA_CONFIG_ID" # Auth config ID created above
6user_id = "0000-0000-0000" # UUID from database/application
7
8composio = Composio()
9
10
11def authenticate_toolkit(user_id: str, auth_config_id: str):
12 connection_request = composio.connected_accounts.initiate(
13 user_id=user_id,
14 auth_config_id=auth_config_id,
15 )
16
17 print(
18 f"Visit this URL to authenticate Asana: {connection_request.redirect_url}"
19 )
20
21 # This will wait for the auth flow to be completed
22 connection_request.wait_for_connection(timeout=15)
23 return connection_request.id
24
25
26connection_id = authenticate_toolkit(user_id, asana_auth_config_id)
27
28# You can also verify the connection status using:
29connected_account = composio.connected_accounts.get(connection_id)
30print(f"Connected account: {connected_account}")

Tools

Executing tools

To prototype you can execute some tools to see the responses and working on the Asana toolkit’s playground

Python
1from composio import Composio
2from openai import OpenAI
3import json
4
5openai = OpenAI()
6composio = Composio()
7
8# User ID must be a valid UUID format
9user_id = "0000-0000-0000" # Replace with actual user UUID from your database
10
11tools = composio.tools.get(user_id=user_id, toolkits=["ASANA"])
12
13print("[!] Tools:")
14print(json.dumps(tools))
15
16def invoke_llm(task = "What can you do?"):
17 completion = openai.chat.completions.create(
18 model="gpt-4o",
19 messages=[
20 {
21 "role": "user",
22 "content": task, # Your task here!
23 },
24 ],
25 tools=tools,
26 )
27
28 # Handle Result from tool call
29 result = composio.provider.handle_tool_calls(user_id=user_id, response=completion)
30 print(f"[!] Completion: {completion}")
31 print(f"[!] Tool call result: {result}")
32
33invoke_llm()

Tool List

Tool Name: Add Followers to Task

Description

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
objectRequired
error
string
successful
booleanRequired

Tool Name: Add Supporting Relationship to Goal

Description

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
booleanRequired

Tool Name: Add task to section

Description

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
objectRequired
error
string
successful
booleanRequired

Tool Name: Create Allocation

Description

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
objectRequired
error
string
successful
booleanRequired

Tool Name: Create Attachment for Task

Description

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
booleanRequired

Tool Name: Create Custom Field

Description

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
objectRequired
error
string
successful
booleanRequired

Tool Name: Create Enum Option for Custom Field

Description

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
booleanRequired

Tool Name: Create Project Status Update

Description

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
booleanRequired

Tool Name: Create a section in a project

Description

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
objectRequired
error
string
successful
booleanRequired

Tool Name: Create subtask

Description

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
objectRequired
error
string
successful
booleanRequired

Tool Name: Create task comment

Description

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
objectRequired
error
string
successful
booleanRequired

Tool Name: Delete Allocation

Description

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
booleanRequired

Tool Name: Delete Attachment

Description

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
booleanRequired

Tool Name: Delete Custom Field

Description

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
booleanRequired

Tool Name: Delete a project

Description

Delete a project.

Action Parameters

opt_pretty
boolean
project_gid
stringRequired

Action Response

data
object
error
string
successful
booleanRequired

Tool Name: Delete a Tag

Description

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
booleanRequired

Tool Name: Delete a task

Description

Delete a task.

Action Parameters

opt_pretty
boolean
task_gid
stringRequired

Action Response

data
object
error
string
successful
booleanRequired

Tool Name: Duplicate Project

Description

Duplicate a project.

Action Parameters

include
array
name
stringRequired
project_gid
stringRequired
schedule_dates
object
team
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Duplicate Task

Description

Duplicate a task

Action Parameters

include
array
name
string
task_gid
stringRequired

Action Response

data
object
error
string
successful
booleanRequired

Tool Name: Get Allocation

Description

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
booleanRequired

Tool Name: Get Allocations

Description

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
arrayRequired
error
string
next_page
object
successful
booleanRequired

Tool Name: Get Attachment

Description

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
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Audit Log Events

Description

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
booleanRequired

Tool Name: Get a project

Description

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
objectRequired
error
string
successful
booleanRequired

Tool Name: Get a task

Description

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
objectRequired
error
string
successful
booleanRequired

Tool Name: Get current user

Description

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
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Custom Field

Description

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
booleanRequired

Tool Name: Get Custom Fields for Workspace

Description

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
arrayRequired
error
string
next_page
object
successful
booleanRequired

Tool Name: Get Events on a Resource

Description

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
booleanRequired
sync
string

Tool Name: Get Goal

Description

Retrieve the full record for a single goal by its gid.

Action Parameters

goal_gid
stringRequired
opt_fields
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Goals

Description

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
booleanRequired

Tool Name: Get Goal Relationships

Description

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
arrayRequired
error
string
successful
booleanRequired

Tool Name: Get Memberships

Description

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
arrayRequired
error
string
next_page
object
successful
booleanRequired

Tool Name: Get Portfolio

Description

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
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Portfolios

Description

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
arrayRequired
error
string
next_page
object
successful
booleanRequired

Tool Name: Get Portfolio Items

Description

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
booleanRequired

Tool Name: Get Portfolio Memberships

Description

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
booleanRequired

Tool Name: Get Projects for Team

Description

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
arrayRequired
error
string
next_page
object
successful
booleanRequired

Tool Name: Get Project Brief

Description

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
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Project Memberships

Description

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
booleanRequired

Tool Name: Get Project Status

Description

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
booleanRequired

Tool Name: Get Project Status Updates

Description

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
booleanRequired

Tool Name: Get Multiple Project Templates

Description

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
arrayRequired
error
string
next_page
object
successful
booleanRequired

Tool Name: Get Section

Description

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
objectRequired
error
string
successful
booleanRequired

Tool Name: Get sections in a project

Description

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
arrayRequired
error
string
successful
booleanRequired

Tool Name: Get Status Updates

Description

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
arrayRequired
error
string
next_page
object
successful
booleanRequired

Tool Name: Get Stories for Task

Description

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
booleanRequired

Tool Name: Get Story

Description

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
booleanRequired

Tool Name: Get Tag

Description

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
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Tags

Description

Get multiple tags in a workspace.

Action Parameters

limit
integer
offset
string
opt_fields
array
workspace
string

Action Response

data
arrayRequired
error
string
next_page
object
successful
booleanRequired

Tool Name: Retrieve tasks for project

Description

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
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Task Attachments

Description

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
booleanRequired

Tool Name: Get Task Subtasks

Description

Action Parameters

limit
integer
offset
string
opt_fields
array
task_gid
stringRequired

Action Response

data
arrayRequired
error
string
next_page
object
successful
booleanRequired

Tool Name: Get Task Templates

Description

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
booleanRequired

Tool Name: Get teams in workspace

Description

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
arrayRequired
error
string
successful
booleanRequired

Tool Name: Get Team Memberships

Description

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
booleanRequired

Tool Name: Get Time Periods

Description

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
arrayRequired
error
string
next_page
object
successful
booleanRequired

Tool Name: Get Objects via Typeahead

Description

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
arrayRequired
error
string
successful
booleanRequired

Tool Name: Get User

Description

Get a user by their id.

Action Parameters

opt_fields
array
opt_pretty
boolean
user_gid
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Users for Team

Description

Get users in a team.

Action Parameters

limit
integer
offset
string
opt_fields
array
opt_pretty
boolean
team_gid
stringRequired

Action Response

data
arrayRequired
error
string
next_page
object
successful
booleanRequired

Tool Name: Get Users in Workspace

Description

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
arrayRequired
error
string
next_page
object
successful
booleanRequired

Tool Name: Get Workspace Memberships

Description

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
booleanRequired

Tool Name: Get Workspace Projects

Description

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
arrayRequired
error
string
next_page
object
successful
booleanRequired

Tool Name: Insert or Reorder Enum Option for Custom Field

Description

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
objectRequired
error
string
successful
booleanRequired

Tool Name: Remove Follower From Task

Description

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
objectRequired
error
string
successful
booleanRequired

Tool Name: Submit Parallel Requests (Batch API)

Description

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
booleanRequired

Tool Name: Update Allocation

Description

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
objectRequired
error
string
successful
booleanRequired

Tool Name: Update Custom Field

Description

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
objectRequired
error
string
successful
booleanRequired

Tool Name: Update Enum Option

Description

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
objectRequired
error
string
successful
booleanRequired

Tool Name: Update a project

Description

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
objectRequired
error
string
successful
booleanRequired

Tool Name: Update Tag

Description

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
objectRequired
error
string
successful
booleanRequired

Tool Name: Create a project

Description

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
objectRequired
error
string
successful
booleanRequired

Tool Name: Create a tag in a workspace

Description

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
objectRequired
error
string
successful
booleanRequired

Tool Name: Create task in asana with specific details

Description

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
objectRequired
error
string
successful
booleanRequired

Tool Name: Create Team

Description

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
objectRequired
error
string
successful
booleanRequired

Tool Name: Get a user task list

Description

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
objectRequired
error
string
successful
booleanRequired

Tool Name: Get multiple projects

Description

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
objectRequired
error
string
successful
booleanRequired

Tool Name: Get multiple tasks

Description

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
objectRequired
error
string
successful
booleanRequired

Tool Name: Get multiple users

Description

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
objectRequired
error
string
successful
booleanRequired

Tool Name: Get multiple workspaces

Description

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
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Team

Description

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
booleanRequired

Tool Name: Get Workspace

Description

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
booleanRequired

Tool Name: Update a task

Description

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
objectRequired
error
string
successful
booleanRequired

Tool Name: Update a team

Description

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
objectRequired
error
string
successful
booleanRequired