Asana connector

1. Install the SDK

   Node.js

   npm install @scalekit-sdk/node

   Python

   pip install scalekit

   Full SDK reference: Node.js | Python

2. Set your credentials

   Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

   .env

   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>

3. Set up the connector

   Register your Asana credentials with Scalekit so it handles the token lifecycle. You do this once per environment.

   Dashboard setup steps

   Register your Scalekit environment with the Asana connector so Scalekit handles the authentication flow and token lifecycle for you. The connection name you create will be used to identify and invoke the connection programmatically. Then complete the configuration in your application as follows:

   1. Set up auth redirects

      • In Scalekit dashboard, go to AgentKit > Connections > Create Connection. Find Asana and click Create. Copy the redirect URI. It looks like https://<SCALEKIT_ENVIRONMENT_URL>/sso/v1/oauth/<CONNECTION_ID>/callback.

        

      • Go to Asana Developer Console and click Create new app. Enter an app name.

      • In the left menu, go to OAuth. Under Redirect URLs, click Add redirect URL, paste the redirect URI from Scalekit, and click Add.

        

   2. Enable multi-workspace install Optional

      Enable this if you want users outside your Asana workspace to install the app.

      • In your app settings, go to OAuth → App permissions.

      • Under App install permissions, enable Allow users outside your workspace to install this app.

        

   3. Get client credentials

      • In Asana Developer Console, select your app.
      • Under OAuth, copy your Client ID and Client Secret.

   4. Add credentials in Scalekit

      • In Scalekit dashboard, go to AgentKit > Connections and open the connection you created.

      • Enter your credentials:

        • Client ID (from above)
        • Client Secret (from above)
        • Permissions (scopes — see Asana OAuth scopes reference)

        

      • Click Save.

4. Authorize and make your first call

   Node.js

   quickstart.ts

   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   
   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENV_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions
   
   const connector = 'asana'
   const identifier = 'user_123'
   
   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize Asana:', link)
   process.stdout.write('Press Enter after authorizing...')
   await new Promise(r => process.stdin.once('data', r))
   
   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'asana_allocations_list',
     toolInput: {},
   })
   console.log(result)

   Python

   quickstart.py

   import os
   from scalekit.client import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()
   
   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENV_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions
   
   connection_name = "asana"
   identifier = "user_123"
   
   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize Asana:", link_response.link)
   input("Press Enter after authorizing...")
   
   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="asana_allocations_list",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)

What you can do

Connect this agent connector to let your agent:

• Create allocation, attachment, custom field — Create a resource allocation for a user on a project
• Delete allocation, attachment, custom field — Permanently delete a resource allocation by its GID
• Get allocation, attachment, custom field — Get a single resource allocation record by its GID
• Update allocation, custom field, enum option — Update an existing resource allocation
• List allocations, attachments, goal parent goals — List resource allocations
• Followers goal add, goal remove, project add — Add one or more followers to a goal

Common workflows

Proxy API call

Node.js

const result = await actions.request({
  connectionName: 'asana',
  identifier: 'user_123',
  path: '/api/1.0/users/me',
  method: 'GET',
});
console.log(result);

Python

result = actions.request(
    connection_name='asana',
    identifier='user_123',
    path="/api/1.0/users/me",
    method="GET",
)
print(result)

Tool list

Use the exact tool names from the Tool list below when you call execute_tool. If you’re not sure which name to use, list the tools available for the current user first.

asana_allocation_create#Create a resource allocation for a user on a project. Optionally specify start/end dates and effort percentage.5 params▾

Create a resource allocation for a user on a project. Optionally specify start/end dates and effort percentage.

NameTypeRequiredDescription

assignee_gidstringrequiredGID of the user to allocate to the project

parent_gidstringrequiredGID of the project this allocation is for

effort_percentnumberoptionalEffort percentage for the allocation, from 0 to 100

end_datestringoptionalEnd date of the allocation in YYYY-MM-DD format

start_datestringoptionalStart date of the allocation in YYYY-MM-DD format

asana_allocation_delete#Permanently delete a resource allocation by its GID. This action cannot be undone.1 param▾

Permanently delete a resource allocation by its GID. This action cannot be undone.

NameTypeRequiredDescription

allocation_gidstringrequiredGID of the allocation to delete

asana_allocation_get#Get a single resource allocation record by its GID.2 params▾

Get a single resource allocation record by its GID.

NameTypeRequiredDescription

allocation_gidstringrequiredGID of the allocation to retrieve

opt_fieldsstringoptionalComma-separated list of optional fields to include in the response

asana_allocation_update#Update an existing resource allocation. You can update start date, end date, and/or effort percentage. Only provided fields are updated.4 params▾

Update an existing resource allocation. You can update start date, end date, and/or effort percentage. Only provided fields are updated.

NameTypeRequiredDescription

allocation_gidstringrequiredGID of the allocation to update

effort_percentnumberoptionalNew effort percentage for the allocation, from 0 to 100

end_datestringoptionalNew end date for the allocation in YYYY-MM-DD format

start_datestringoptionalNew start date for the allocation in YYYY-MM-DD format

asana_allocations_list#List resource allocations. At least one of assignee_gid or parent_gid is required by the Asana API.3 params▾

List resource allocations. At least one of assignee_gid or parent_gid is required by the Asana API.

NameTypeRequiredDescription

assignee_gidstringoptionalGID of the user to filter allocations by assignee

opt_fieldsstringoptionalComma-separated list of optional fields to include in the response

parent_gidstringoptionalGID of the parent project or portfolio to filter allocations by

asana_attachment_create#Upload a file attachment to a task by URL (external/url attachment type).4 params▾

Upload a file attachment to a task by URL (external/url attachment type).

NameTypeRequiredDescription

namestringrequiredThe display name (filename) for the attachment

parent_gidstringrequiredGID of the task to attach the file to

urlstringrequiredThe publicly accessible URL of the file to attach

descriptionstringoptionalOptional description for the attachment

asana_attachment_delete#Delete an attachment permanently.1 param▾

Delete an attachment permanently.

NameTypeRequiredDescription

attachment_gidstringrequiredGID of the attachment to delete

asana_attachment_get#Get details of a specific attachment by its GID.2 params▾

Get details of a specific attachment by its GID.

NameTypeRequiredDescription

attachment_gidstringrequiredGID of the attachment to retrieve

opt_fieldsstringoptionalComma-separated list of optional fields to include in response

asana_attachments_list#List all attachments for a task or project.2 params▾

List all attachments for a task or project.

NameTypeRequiredDescription

parent_gidstringrequiredGID of the task or project to list attachments for

opt_fieldsstringoptionalComma-separated list of optional fields to include in response

asana_custom_field_create#Create a custom field in a workspace.5 params▾

Create a custom field in a workspace.

NameTypeRequiredDescription

field_typestringrequiredType of the custom field. One of: text, number, enum, multi_enum, date, people

namestringrequiredName of the custom field

workspace_gidstringrequiredGID of the workspace in which to create the custom field

descriptionstringoptionalDescription of the custom field

opt_fieldsstringoptionalComma-separated list of optional fields to include in response

asana_custom_field_delete#Permanently delete a custom field. This action cannot be undone.1 param▾

Permanently delete a custom field. This action cannot be undone.

NameTypeRequiredDescription

custom_field_gidstringrequiredGID of the custom field to delete

asana_custom_field_enum_option_create#Add an enum option to a custom field of type enum or multi_enum.3 params▾

Add an enum option to a custom field of type enum or multi_enum.

NameTypeRequiredDescription

custom_field_gidstringrequiredGID of the custom field to add an enum option to

namestringrequiredName of the enum option

colorstringoptionalColor of the enum option (e.g. red, orange, yellow, green, teal, blue, indigo, purple, pink)

asana_custom_field_get#Get a custom field definition by its GID.2 params▾

Get a custom field definition by its GID.

NameTypeRequiredDescription

custom_field_gidstringrequiredGID of the custom field to retrieve

opt_fieldsstringoptionalComma-separated list of optional fields to include in response

asana_custom_field_update#Update an existing custom field. Provide name and/or description to update.4 params▾

Update an existing custom field. Provide name and/or description to update.

NameTypeRequiredDescription

custom_field_gidstringrequiredGID of the custom field to update

descriptionstringoptionalNew description for the custom field

namestringoptionalNew name for the custom field

opt_fieldsstringoptionalComma-separated list of optional fields to include in response

asana_enum_option_update#Update an enum option on a custom field. Can change the name, color, and enabled status.4 params▾

Update an enum option on a custom field. Can change the name, color, and enabled status.

NameTypeRequiredDescription

enum_option_gidstringrequiredGID of the enum option to update

namestringrequiredNew name for the enum option

colorstringoptionalNew color for the enum option (e.g. red, orange, yellow, green, teal, blue, indigo, purple, pink)

enabledbooleanoptionalWhether the enum option is enabled. Disabled options are hidden from the UI.

asana_goal_add_followers#Add one or more followers to a goal.2 params▾

Add one or more followers to a goal.

NameTypeRequiredDescription

followersstringrequiredComma-separated list of user GIDs to add as followers

goal_gidstringrequiredGID of the goal to add followers to

asana_goal_add_supporting_relationship#Add a supporting relationship to a goal, linking a sub-goal, project, or task as a supporting resource.3 params▾

Add a supporting relationship to a goal, linking a sub-goal, project, or task as a supporting resource.

NameTypeRequiredDescription

goal_gidstringrequiredGID of the goal to add a supporting relationship to

supporting_resource_gidstringrequiredGID of the goal, project, or task to link as a supporting resource

contribution_weightnumberoptionalWeight of the supporting resource's contribution to the goal (0–1)

asana_goal_create#Create a new goal in a workspace.6 params▾

Create a new goal in a workspace.

NameTypeRequiredDescription

namestringrequiredName of the goal

workspace_gidstringrequiredGID of the workspace in which to create the goal

due_onstringoptionalDue date for the goal in ISO 8601 date format (YYYY-MM-DD)

notesstringoptionalFree-form notes / description for the goal

opt_fieldsstringoptionalComma-separated list of optional fields to include in response

ownerstringoptionalGID of the user who owns this goal, or "me" for the current user

asana_goal_delete#Permanently delete a goal. This action cannot be undone.1 param▾

Permanently delete a goal. This action cannot be undone.

NameTypeRequiredDescription

goal_gidstringrequiredGID of the goal to delete

asana_goal_get#Get details of a specific goal including its metric and current value.2 params▾

Get details of a specific goal including its metric and current value.

NameTypeRequiredDescription

goal_gidstringrequiredGID of the goal to retrieve

opt_fieldsstringoptionalComma-separated list of optional fields to include in response

asana_goal_parent_goals_list#List all parent goals for a given goal.2 params▾

List all parent goals for a given goal.

NameTypeRequiredDescription

goal_gidstringrequiredGID of the goal whose parent goals to list

opt_fieldsstringoptionalComma-separated list of optional fields to include in response

asana_goal_relationship_get#Get a goal relationship by its GID.2 params▾

Get a goal relationship by its GID.

NameTypeRequiredDescription

goal_relationship_gidstringrequiredGID of the goal relationship to retrieve

opt_fieldsstringoptionalComma-separated list of optional fields to include in response

asana_goal_relationships_list#List goal relationships, optionally filtered by a supported goal.2 params▾

List goal relationships, optionally filtered by a supported goal.

NameTypeRequiredDescription

supported_goal_gidstringrequiredGID of the goal whose relationships to list

opt_fieldsstringoptionalComma-separated list of optional fields to include in response

asana_goal_remove_followers#Remove one or more followers from a goal.2 params▾

Remove one or more followers from a goal.

NameTypeRequiredDescription

followersstringrequiredComma-separated list of user GIDs to remove as followers

goal_gidstringrequiredGID of the goal to remove followers from

asana_goal_remove_supporting_relationship#Remove a supporting relationship from a goal, unlinking a sub-goal, project, or task.2 params▾

Remove a supporting relationship from a goal, unlinking a sub-goal, project, or task.

NameTypeRequiredDescription

goal_gidstringrequiredGID of the goal to remove the supporting relationship from

supporting_resource_gidstringrequiredGID of the supporting resource to unlink from the goal

asana_goal_set_metric#Set or update the metric for a goal (e.g. percentage, number, currency).4 params▾

Set or update the metric for a goal (e.g. percentage, number, currency).

NameTypeRequiredDescription

goal_gidstringrequiredGID of the goal on which to set the metric

metric_typestringrequiredType of metric for this goal

target_valuenumberoptionalTarget numeric value for the goal metric

unitstringoptionalUnit label for the metric (e.g. USD, users, leads)

asana_goal_set_metric_value#Update the current value of a goal metric to track progress.2 params▾

Update the current value of a goal metric to track progress.

NameTypeRequiredDescription

current_valuenumberrequiredThe new current numeric value for the goal metric

goal_gidstringrequiredGID of the goal whose metric current value should be updated

asana_goal_stories_list#List stories (activity feed entries) for a goal.2 params▾

List stories (activity feed entries) for a goal.

NameTypeRequiredDescription

goal_gidstringrequiredGID of the goal whose stories to list

opt_fieldsstringoptionalComma-separated list of optional fields to include in response

asana_goal_story_create#Add a comment or story to a goal's activity feed.2 params▾

Add a comment or story to a goal's activity feed.

NameTypeRequiredDescription

goal_gidstringrequiredGID of the goal to add a story to

textstringrequiredText content of the story / comment to add

asana_goal_update#Update an existing goal's name, notes, due date, or status.5 params▾

Update an existing goal's name, notes, due date, or status.

NameTypeRequiredDescription

goal_gidstringrequiredGID of the goal to update

due_onstringoptionalUpdated due date in ISO 8601 date format (YYYY-MM-DD)

namestringoptionalUpdated name for the goal

notesstringoptionalUpdated free-form notes / description for the goal

statusstringoptionalUpdated status of the goal

asana_goals_list#Get goals for a workspace, optionally filtered by team or time period.4 params▾

Get goals for a workspace, optionally filtered by team or time period.

NameTypeRequiredDescription

workspace_gidstringrequiredGID of the workspace to list goals from

is_workspace_levelbooleanoptionalIf true, filter to only workspace-level goals (not team goals)

opt_fieldsstringoptionalComma-separated list of optional fields to include in response

team_gidstringoptionalGID of the team to filter goals by

asana_job_get#Get the status of an async job (e.g. from project or task duplication). Poll until status is "succeeded" or "failed".2 params▾

Get the status of an async job (e.g. from project or task duplication). Poll until status is "succeeded" or "failed".

NameTypeRequiredDescription

job_gidstringrequiredGID of the async job to retrieve

opt_fieldsstringoptionalComma-separated list of optional fields to include in response

asana_me_get#Get the profile of the authenticated user.1 param▾

Get the profile of the authenticated user.

NameTypeRequiredDescription

opt_fieldsstringoptionalComma-separated list of optional fields to include in response

asana_membership_create#Add a user as a member of a project or goal. Optionally specify a role for the membership.3 params▾

Add a user as a member of a project or goal. Optionally specify a role for the membership.

NameTypeRequiredDescription

member_gidstringrequiredGID of the user to add as a member

parent_gidstringrequiredGID of the project or goal to add the member to

rolestringoptionalRole to assign to the new member (e.g. editor, commenter, viewer)

asana_membership_delete#Remove a member from a project or goal by deleting the membership record. This action cannot be undone.1 param▾

Remove a member from a project or goal by deleting the membership record. This action cannot be undone.

NameTypeRequiredDescription

membership_gidstringrequiredGID of the membership to delete

asana_membership_get#Get the details of a single membership record by its GID.2 params▾

Get the details of a single membership record by its GID.

NameTypeRequiredDescription

membership_gidstringrequiredGID of the membership record to retrieve

opt_fieldsstringoptionalComma-separated list of optional fields to include in the response

asana_membership_update#Update the role of an existing membership record.2 params▾

Update the role of an existing membership record.

NameTypeRequiredDescription

membership_gidstringrequiredGID of the membership record to update

rolestringrequiredNew role to assign to the member (e.g. editor, commenter, viewer)

asana_memberships_list#List memberships for a project or goal, optionally filtered by a specific member.3 params▾

List memberships for a project or goal, optionally filtered by a specific member.

NameTypeRequiredDescription

parent_gidstringrequiredGID of the project or goal to list memberships for

member_gidstringoptionalGID of a member (user) to filter memberships by

opt_fieldsstringoptionalComma-separated list of optional fields to include in the response

asana_my_tasks_list#Get tasks from the authenticated user's personal My Tasks list in a workspace.3 params▾

Get tasks from the authenticated user's personal My Tasks list in a workspace.

NameTypeRequiredDescription

user_task_list_gidstringrequiredGID of the user task list (My Tasks list) to retrieve tasks from

completed_sincestringoptionalISO 8601 timestamp; only return tasks completed after this time

opt_fieldsstringoptionalComma-separated list of optional fields to include in response

asana_portfolio_add_item#Add a project to a portfolio.2 params▾

Add a project to a portfolio.

NameTypeRequiredDescription

item_gidstringrequiredGID of the project to add to the portfolio

portfolio_gidstringrequiredGID of the portfolio to add an item to

asana_portfolio_add_members#Add one or more members to a portfolio by their user GIDs.2 params▾

Add one or more members to a portfolio by their user GIDs.

NameTypeRequiredDescription

membersstringrequiredComma-separated list of user GIDs to add as members

portfolio_gidstringrequiredGID of the portfolio to add members to

asana_portfolio_create#Create a new portfolio in a workspace.4 params▾

Create a new portfolio in a workspace.

NameTypeRequiredDescription

namestringrequiredName of the portfolio

workspace_gidstringrequiredGID of the workspace to create the portfolio in

colorstringoptionalColor of the portfolio

opt_fieldsstringoptionalComma-separated list of optional fields to include in response

asana_portfolio_custom_field_settings_list#List all custom field settings for a portfolio, including which custom fields are attached and their display configuration.2 params▾

List all custom field settings for a portfolio, including which custom fields are attached and their display configuration.

NameTypeRequiredDescription

portfolio_gidstringrequiredGID of the portfolio to list custom field settings for

opt_fieldsstringoptionalComma-separated list of optional fields to include in response

asana_portfolio_delete#Permanently delete a portfolio by its GID. This action cannot be undone.1 param▾

Permanently delete a portfolio by its GID. This action cannot be undone.

NameTypeRequiredDescription

portfolio_gidstringrequiredGID of the portfolio to delete

asana_portfolio_get#Get details of a specific portfolio by its GID.2 params▾

Get details of a specific portfolio by its GID.

NameTypeRequiredDescription

portfolio_gidstringrequiredGID of the portfolio to retrieve

opt_fieldsstringoptionalComma-separated list of optional fields to include in response

asana_portfolio_items_list#Get all items (projects or portfolios) contained in a portfolio.2 params▾

Get all items (projects or portfolios) contained in a portfolio.

NameTypeRequiredDescription

portfolio_gidstringrequiredGID of the portfolio whose items to list

opt_fieldsstringoptionalComma-separated list of optional fields to include in response

asana_portfolio_membership_get#Get a single portfolio membership record by its GID.2 params▾

Get a single portfolio membership record by its GID.

NameTypeRequiredDescription

portfolio_membership_gidstringrequiredGID of the portfolio membership to retrieve

opt_fieldsstringoptionalComma-separated list of optional fields to include in the response

asana_portfolio_memberships_list#List all members of a portfolio, optionally filtered by a specific user.3 params▾

List all members of a portfolio, optionally filtered by a specific user.

NameTypeRequiredDescription

portfolio_gidstringrequiredGID of the portfolio whose memberships to list

opt_fieldsstringoptionalComma-separated list of optional fields to include in response

user_gidstringoptionalGID of a user to filter memberships by

asana_portfolio_remove_item#Remove a project from a portfolio.2 params▾

Remove a project from a portfolio.

NameTypeRequiredDescription

item_gidstringrequiredGID of the project to remove from the portfolio

portfolio_gidstringrequiredGID of the portfolio to remove an item from

asana_portfolio_remove_members#Remove one or more members from a portfolio by their user GIDs.2 params▾

Remove one or more members from a portfolio by their user GIDs.

NameTypeRequiredDescription

membersstringrequiredComma-separated list of user GIDs to remove from the portfolio

portfolio_gidstringrequiredGID of the portfolio to remove members from

asana_portfolio_update#Update a portfolio's name or color.4 params▾

Update a portfolio's name or color.

NameTypeRequiredDescription

portfolio_gidstringrequiredGID of the portfolio to update

colorstringoptionalNew color for the portfolio

namestringoptionalNew name for the portfolio

opt_fieldsstringoptionalComma-separated list of optional fields to include in response

asana_portfolios_list#Get all portfolios accessible to the authenticated user in a workspace.3 params▾

Get all portfolios accessible to the authenticated user in a workspace.

NameTypeRequiredDescription

workspace_gidstringrequiredGID of the workspace to filter portfolios by

opt_fieldsstringoptionalComma-separated list of optional fields to include in response

ownerstringoptionalGID of a user or 'me' to filter portfolios by owner

asana_project_add_custom_field#Add a custom field to a project. Optionally mark the field as important (displayed prominently in the project view).3 params▾

Add a custom field to a project. Optionally mark the field as important (displayed prominently in the project view).

NameTypeRequiredDescription

custom_field_gidstringrequiredGID of the custom field to add to the project

project_gidstringrequiredGID of the project to add the custom field to

is_importantbooleanoptionalWhether the custom field is important and should be displayed prominently in the project view

asana_project_add_followers#Add followers to a project by their GIDs.3 params▾

Add followers to a project by their GIDs.

NameTypeRequiredDescription

followersstringrequiredComma-separated list of user GIDs to add as followers

project_gidstringrequiredGID of the project to add followers to

opt_fieldsstringoptionalComma-separated list of optional fields to include in response

asana_project_add_members#Add members to a project by their GIDs.3 params▾

Add members to a project by their GIDs.

NameTypeRequiredDescription

membersstringrequiredComma-separated list of user GIDs or 'me' to add as members

project_gidstringrequiredGID of the project to add members to

opt_fieldsstringoptionalComma-separated list of optional fields to include in response

asana_project_brief_create#Create a project brief for a project. A project brief is a rich text overview that describes the project's goals and context. Provide the project GID and a title; optionally include plain text or HTML content for the brief body.4 params▾

Create a project brief for a project. A project brief is a rich text overview that describes the project's goals and context. Provide the project GID and a title; optionally include plain text or HTML content for the brief body.

NameTypeRequiredDescription

project_gidstringrequiredGlobally unique identifier for the project to create the brief for. e.g. 1234567890

titlestringrequiredThe title of the project brief. e.g. 'Q3 Launch Plan'

html_textstringoptionalHTML-formatted content for the project brief body. Cannot be used together with text. e.g. '<body><p>This project aims to...</p></body>'

textstringoptionalPlain text content for the project brief body. Cannot be used together with html_text. e.g. 'This project aims to...'

asana_project_brief_get#Get the project brief (rich text overview) for a project by its project brief GID. Returns the title, HTML text, and related project details.2 params▾

Get the project brief (rich text overview) for a project by its project brief GID. Returns the title, HTML text, and related project details.

NameTypeRequiredDescription

project_brief_gidstringrequiredGlobally unique identifier for the project brief to retrieve. e.g. 1234567890

opt_fieldsstringoptionalComma-separated list of optional fields to include in the response. e.g. title,html_text,project,project.name

asana_project_brief_update#Update an existing project brief. You can update the title, plain text body, or HTML body. Provide only the fields you want to change; omitted fields are left unchanged.4 params▾

Update an existing project brief. You can update the title, plain text body, or HTML body. Provide only the fields you want to change; omitted fields are left unchanged.

NameTypeRequiredDescription

project_brief_gidstringrequiredGlobally unique identifier for the project brief to update. e.g. 1234567890

html_textstringoptionalUpdated HTML content for the project brief body. Cannot be used together with text. e.g. '<body><p>Updated description</p></body>'

textstringoptionalUpdated plain text content for the project brief body. Cannot be used together with html_text.

titlestringoptionalNew title for the project brief. e.g. 'Updated Q3 Launch Plan'

asana_project_create#Create a new project in a workspace.10 params▾

Create a new project in a workspace.

NameTypeRequiredDescription

namestringrequiredName of the project

workspace_gidstringrequiredGID of the workspace to create the project in

colorstringoptionalColor of the project

default_viewstringoptionalDefault view for the project

due_onstringoptionalDue date for the project (YYYY-MM-DD)

notesstringoptionalFree-form text description for the project

opt_fieldsstringoptionalComma-separated list of optional fields to include in response

privacy_settingstringoptionalPrivacy setting for the project

start_onstringoptionalStart date for the project (YYYY-MM-DD)

teamstringoptionalGID of the team to share the project with

asana_project_custom_field_settings_list#List all custom field settings for a project, including which custom fields are attached and their display configuration.2 params▾

List all custom field settings for a project, including which custom fields are attached and their display configuration.

NameTypeRequiredDescription

project_gidstringrequiredGID of the project to list custom field settings for

opt_fieldsstringoptionalComma-separated list of optional fields to include in response

asana_project_delete#Delete a project permanently.1 param▾

Delete a project permanently.

NameTypeRequiredDescription

project_gidstringrequiredGID of the project to delete

asana_project_duplicate#Create a duplicate of an existing project.4 params▾

Create a duplicate of an existing project.

NameTypeRequiredDescription

namestringrequiredName for the duplicated project

project_gidstringrequiredGID of the project to duplicate

opt_fieldsstringoptionalComma-separated list of optional fields to include in response

teamstringoptionalGID of the team for the duplicated project

asana_project_get#Get details of a specific project by its GID.2 params▾

Get details of a specific project by its GID.

NameTypeRequiredDescription

project_gidstringrequiredGID of the project to retrieve

opt_fieldsstringoptionalComma-separated list of optional fields to include in response

asana_project_membership_get#Get a specific project membership record by its GID. Returns user identity and access level details for that membership.2 params▾

Get a specific project membership record by its GID. Returns user identity and access level details for that membership.

NameTypeRequiredDescription

project_membership_gidstringrequiredGlobally unique identifier for the project membership record to retrieve. e.g. 1234567890

opt_fieldsstringoptionalComma-separated list of optional fields to include in the response. e.g. user,user.name,access_level,project

asana_project_memberships_list#List all members of a project. Returns membership records including user and access level details for each member of the specified project.3 params▾

List all members of a project. Returns membership records including user and access level details for each member of the specified project.

NameTypeRequiredDescription

project_gidstringrequiredGlobally unique identifier for the project whose members to list. e.g. 1234567890

opt_fieldsstringoptionalComma-separated list of optional fields to include in the response. e.g. user,user.name,access_level

user_gidstringoptionalFilter results to the membership record for a specific user GID. e.g. 987654321

asana_project_remove_followers#Remove followers from a project by their GIDs.2 params▾

Remove followers from a project by their GIDs.

NameTypeRequiredDescription

followersstringrequiredComma-separated list of user GIDs to remove as followers

project_gidstringrequiredGID of the project to remove followers from

asana_project_remove_members#Remove members from a project by their GIDs.2 params▾

Remove members from a project by their GIDs.

NameTypeRequiredDescription

membersstringrequiredComma-separated list of user GIDs to remove as members

project_gidstringrequiredGID of the project to remove members from

asana_project_status_create#Create a new status update for a project with a color-coded health indicator.5 params▾

Create a new status update for a project with a color-coded health indicator.

NameTypeRequiredDescription

colorstringrequiredColor-coded health indicator for the status update

project_gidstringrequiredGID of the project to post the status update to

textstringrequiredThe status update text body

opt_fieldsstringoptionalComma-separated list of optional fields to include in response

titlestringoptionalOptional title for the status update

asana_project_status_get#Get a specific project status update by its GID.2 params▾

Get a specific project status update by its GID.

NameTypeRequiredDescription

project_status_gidstringrequiredGID of the project status update to retrieve

opt_fieldsstringoptionalComma-separated list of optional fields to include in response

asana_project_statuses_list#Get all status updates posted to a project.2 params▾

Get all status updates posted to a project.

NameTypeRequiredDescription

project_gidstringrequiredGID of the project to retrieve status updates for

opt_fieldsstringoptionalComma-separated list of optional fields to include in response

asana_project_task_counts_get#Get task completion counts for a project, including totals for completed and incomplete tasks.2 params▾

Get task completion counts for a project, including totals for completed and incomplete tasks.

NameTypeRequiredDescription

project_gidstringrequiredGID of the project to retrieve task counts for

opt_fieldsstringoptionalComma-separated list of optional fields to include in response

asana_project_tasks_list#List all tasks in a specific project.2 params▾

List all tasks in a specific project.

NameTypeRequiredDescription

project_gidstringrequiredGID of the project to list tasks from

opt_fieldsstringoptionalComma-separated list of optional fields to include in response

asana_project_template_get#Get the details of a single project template by its GID.2 params▾

Get the details of a single project template by its GID.

NameTypeRequiredDescription

project_template_gidstringrequiredGID of the project template to retrieve

opt_fieldsstringoptionalComma-separated list of optional fields to include in the response

asana_project_template_instantiate#Create a new project from a project template. Returns a Job GID — poll asana_job_get until status is complete.4 params▾

Create a new project from a project template. Returns a Job GID — poll asana_job_get until status is complete.

NameTypeRequiredDescription

namestringrequiredName of the new project to create from the template

project_template_gidstringrequiredGID of the project template to instantiate

team_gidstringrequiredGID of the team the new project should belong to

is_strictbooleanoptionalIf true, the endpoint will fail if any unresolvable variables are found in the template

asana_project_templates_list#List project templates available in a workspace or team.3 params▾

List project templates available in a workspace or team.

NameTypeRequiredDescription

opt_fieldsstringoptionalComma-separated list of optional fields to include in the response

team_gidstringoptionalGID of a team to filter project templates by

workspace_gidstringoptionalGID of the workspace to list project templates from

asana_project_update#Update an existing project's properties.10 params▾

Update an existing project's properties.

NameTypeRequiredDescription

project_gidstringrequiredGID of the project to update

archivedbooleanoptionalWhether the project is archived

colorstringoptionalColor of the project

default_viewstringoptionalDefault view for the project

due_onstringoptionalDue date for the project (YYYY-MM-DD)

namestringoptionalNew name for the project

notesstringoptionalFree-form text description for the project

opt_fieldsstringoptionalComma-separated list of optional fields to include in response

privacy_settingstringoptionalPrivacy setting for the project

start_onstringoptionalStart date for the project (YYYY-MM-DD)

asana_projects_list#List projects in a workspace or team.3 params▾

List projects in a workspace or team.

NameTypeRequiredDescription

opt_fieldsstringoptionalComma-separated list of optional fields to include in response

teamstringoptionalGID of a team to filter projects by

workspace_gidstringoptionalGID of the workspace to list projects from

asana_projects_search#Search for projects in a workspace by name or other criteria.4 params▾

Search for projects in a workspace by name or other criteria.

NameTypeRequiredDescription

workspace_gidstringrequiredGID of the workspace to search projects in

archivedbooleanoptionalFilter by archived status; true for archived, false for active, null for both

namestringoptionalFilter projects by name (partial match supported)

opt_fieldsstringoptionalComma-separated list of optional fields to include in response

asana_section_add_task#Move a task into a specific section within a project.4 params▾

Move a task into a specific section within a project.

NameTypeRequiredDescription

section_gidstringrequiredGID of the section to add the task to

task_gidstringrequiredGID of the task to add to the section

insert_afterstringoptionalInsert the task after this task GID within the section

insert_beforestringoptionalInsert the task before this task GID within the section

asana_section_create#Create a new section in a project.3 params▾

Create a new section in a project.

NameTypeRequiredDescription

namestringrequiredName of the section

project_gidstringrequiredGID of the project to create a section in

opt_fieldsstringoptionalComma-separated list of optional fields to include in response

asana_section_delete#Delete a section from a project.1 param▾

Delete a section from a project.

NameTypeRequiredDescription

section_gidstringrequiredGID of the section to delete

asana_section_get#Get details of a specific section by its GID.2 params▾

Get details of a specific section by its GID.

NameTypeRequiredDescription

section_gidstringrequiredGID of the section to retrieve

opt_fieldsstringoptionalComma-separated list of optional fields to include in response

asana_section_tasks_list#List all tasks in a specific section in Asana.2 params▾

List all tasks in a specific section in Asana.

NameTypeRequiredDescription

section_gidstringrequiredGID of the section whose tasks to list

opt_fieldsstringoptionalComma-separated list of optional fields to include in response

asana_section_update#Update the name of a section.3 params▾

Update the name of a section.

NameTypeRequiredDescription

namestringrequiredNew name for the section

section_gidstringrequiredGID of the section to update

opt_fieldsstringoptionalComma-separated list of optional fields to include in response

asana_sections_list#List all sections in a project.2 params▾

List all sections in a project.

NameTypeRequiredDescription

project_gidstringrequiredGID of the project to list sections from

opt_fieldsstringoptionalComma-separated list of optional fields to include in response

asana_status_update_create#Create a status update for a project, portfolio, or goal. This is the preferred endpoint over project_status_create as it supports the newer Asana status updates API.4 params▾

Create a status update for a project, portfolio, or goal. This is the preferred endpoint over project_status_create as it supports the newer Asana status updates API.

NameTypeRequiredDescription

parent_gidstringrequiredGID of the parent resource (project, portfolio, or goal) to create a status update for

status_typestringrequiredThe type of status for this update

textstringrequiredThe body text of the status update

titlestringoptionalThe title of the status update

asana_status_update_delete#Permanently delete a status update.1 param▾

Permanently delete a status update.

NameTypeRequiredDescription

status_update_gidstringrequiredThe GID of the status update to delete

asana_status_update_get#Get a status update by its GID.2 params▾

Get a status update by its GID.

NameTypeRequiredDescription

status_update_gidstringrequiredThe GID of the status update to retrieve

opt_fieldsstringoptionalComma-separated list of optional fields to include in response

asana_status_updates_list#List status updates for a parent resource such as a project, portfolio, or goal.2 params▾

List status updates for a parent resource such as a project, portfolio, or goal.

NameTypeRequiredDescription

parent_gidstringrequiredGID of the parent resource (project, portfolio, or goal) to list status updates for

opt_fieldsstringoptionalComma-separated list of optional fields to include in response

asana_story_create#Add a comment or story to a task.3 params▾

Add a comment or story to a task.

NameTypeRequiredDescription

task_gidstringrequiredGID of the task to add the comment to

textstringrequiredText of the comment to add to the task

opt_fieldsstringoptionalComma-separated list of optional fields to include in response

asana_story_delete#Delete a story (comment) in Asana. This action is irreversible.1 param▾

Delete a story (comment) in Asana. This action is irreversible.

NameTypeRequiredDescription

story_gidstringrequiredGID of the story to delete

asana_story_get#Get details of a specific story by its GID.2 params▾

Get details of a specific story by its GID.

NameTypeRequiredDescription

story_gidstringrequiredGID of the story to retrieve

opt_fieldsstringoptionalComma-separated list of optional fields to include in response

asana_story_update#Update a story (comment) in Asana. Can edit the text of comments.2 params▾

Update a story (comment) in Asana. Can edit the text of comments.

NameTypeRequiredDescription

story_gidstringrequiredGID of the story to update

textstringrequiredUpdated text content of the comment

asana_subtask_create#Create a subtask under an existing task.6 params▾

Create a subtask under an existing task.

NameTypeRequiredDescription

namestringrequiredName of the subtask

task_gidstringrequiredGID of the parent task

assigneestringoptionalGID of the user to assign, or 'me'

due_onstringoptionalDue date for the subtask (YYYY-MM-DD)

notesstringoptionalFree-form description for the subtask

opt_fieldsstringoptionalComma-separated list of optional fields to include in response

asana_tag_create#Create a new tag in a workspace.4 params▾

Create a new tag in a workspace.

NameTypeRequiredDescription

namestringrequiredName of the tag

workspace_gidstringrequiredGID of the workspace to create the tag in

colorstringoptionalColor for the tag

opt_fieldsstringoptionalComma-separated list of optional fields to include in response

asana_tag_delete#Delete a tag permanently.1 param▾

Delete a tag permanently.

NameTypeRequiredDescription

tag_gidstringrequiredGID of the tag to delete

asana_tag_get#Get details of a specific tag by its GID.2 params▾

Get details of a specific tag by its GID.

NameTypeRequiredDescription

tag_gidstringrequiredGID of the tag to retrieve

opt_fieldsstringoptionalComma-separated list of optional fields to include in response

asana_tag_tasks_list#List all tasks that have a specific tag in Asana.2 params▾

List all tasks that have a specific tag in Asana.

NameTypeRequiredDescription

tag_gidstringrequiredGID of the tag whose tasks to list

opt_fieldsstringoptionalComma-separated list of optional fields to include in response

asana_tag_update#Update a tag's name or color.4 params▾

Update a tag's name or color.

NameTypeRequiredDescription

tag_gidstringrequiredGID of the tag to update

colorstringoptionalNew color for the tag

namestringoptionalNew name for the tag

opt_fieldsstringoptionalComma-separated list of optional fields to include in response

asana_tags_list#List tags in a workspace.2 params▾

List tags in a workspace.

NameTypeRequiredDescription

opt_fieldsstringoptionalComma-separated list of optional fields to include in response

workspace_gidstringoptionalGID of the workspace to list tags from

asana_task_add_dependencies#Add dependencies to a task. Dependencies are tasks that must be completed before this task can start.3 params▾

Add dependencies to a task. Dependencies are tasks that must be completed before this task can start.

NameTypeRequiredDescription

dependenciesstringrequiredComma-separated GIDs of tasks this task depends on

task_gidstringrequiredGID of the task to add dependencies to

opt_fieldsstringoptionalComma-separated list of optional fields to include in response

asana_task_add_dependents#Add dependent tasks to a task in Asana. Dependents are tasks that depend on this task being completed first.2 params▾

Add dependent tasks to a task in Asana. Dependents are tasks that depend on this task being completed first.

NameTypeRequiredDescription

dependentsstringrequiredComma-separated list of task GIDs that depend on this task

task_gidstringrequiredGID of the task to add dependents to

asana_task_add_followers#Add followers to a task.3 params▾

Add followers to a task.

NameTypeRequiredDescription

followersstringrequiredComma-separated GIDs of users to add as followers

task_gidstringrequiredGID of the task

opt_fieldsstringoptionalComma-separated list of optional fields to include in response

asana_task_add_project#Add a task to a project.5 params▾

Add a task to a project.

NameTypeRequiredDescription

projectstringrequiredGID of the project to add the task to

task_gidstringrequiredGID of the task to add to a project

insert_afterstringoptionalInsert the task after this task in the project

insert_beforestringoptionalInsert the task before this task in the project

sectionstringoptionalGID of a section in the project to place the task

asana_task_add_tag#Add a tag to a task.2 params▾

Add a tag to a task.

NameTypeRequiredDescription

tagstringrequiredGID of the tag to add to the task

task_gidstringrequiredGID of the task

asana_task_create#Create a new task in Asana.9 params▾

Create a new task in Asana.

NameTypeRequiredDescription

namestringrequiredName of the task

assigneestringoptionalGID of the user to assign, or 'me'

due_onstringoptionalDue date for the task (YYYY-MM-DD)

followersstringoptionalComma-separated GIDs of users to follow the task

notesstringoptionalFree-form text description of the task

opt_fieldsstringoptionalComma-separated list of optional fields to include in response

projectsstringoptionalComma-separated GIDs of projects to add the task to

start_onstringoptionalStart date for the task (YYYY-MM-DD)

workspace_gidstringoptionalGID of the workspace to create the task in (required if no project)

asana_task_delete#Delete a task permanently.1 param▾

Delete a task permanently.

NameTypeRequiredDescription

task_gidstringrequiredGID of the task to delete

asana_task_dependencies_list#Get the list of tasks that a given task depends on.2 params▾

Get the list of tasks that a given task depends on.

NameTypeRequiredDescription

task_gidstringrequiredGID of the task to retrieve dependencies for

opt_fieldsstringoptionalComma-separated list of optional fields to include in response

asana_task_dependents_list#Get the list of tasks that depend on a given task (tasks blocked by this task).2 params▾

Get the list of tasks that depend on a given task (tasks blocked by this task).

NameTypeRequiredDescription

task_gidstringrequiredGID of the task to retrieve dependents for

opt_fieldsstringoptionalComma-separated list of optional fields to include in response

asana_task_duplicate#Create a duplicate of an existing task.4 params▾

Create a duplicate of an existing task.

NameTypeRequiredDescription

namestringrequiredName for the duplicated task

task_gidstringrequiredGID of the task to duplicate

includestringoptionalComma-separated list of fields to copy (assignee, attachments, dates, dependencies, notes, projects, subtasks, tags)

opt_fieldsstringoptionalComma-separated list of optional fields to include in response

asana_task_get#Get details of a specific task by its GID.2 params▾

Get details of a specific task by its GID.

NameTypeRequiredDescription

task_gidstringrequiredGID of the task to retrieve

opt_fieldsstringoptionalComma-separated list of optional fields to include in response

asana_task_get_by_custom_id#Look up a task by its custom external ID within a given workspace.3 params▾

Look up a task by its custom external ID within a given workspace.

NameTypeRequiredDescription

custom_idstringrequiredThe custom external ID of the task to look up

workspace_gidstringrequiredGID of the workspace to search within

opt_fieldsstringoptionalComma-separated list of optional fields to include in the response

asana_task_remove_dependencies#Remove dependencies from a task.3 params▾

Remove dependencies from a task.

NameTypeRequiredDescription

dependenciesstringrequiredComma-separated GIDs of dependency tasks to remove

task_gidstringrequiredGID of the task to remove dependencies from

opt_fieldsstringoptionalComma-separated list of optional fields to include in response

asana_task_remove_dependents#Remove one or more dependent tasks from a task. Dependents are tasks that depend on this task (i.e., this task blocks them). Provide a comma-separated list of dependent task GIDs to unlink.2 params▾

Remove one or more dependent tasks from a task. Dependents are tasks that depend on this task (i.e., this task blocks them). Provide a comma-separated list of dependent task GIDs to unlink.

NameTypeRequiredDescription

dependentsstringrequiredComma-separated list of task GIDs to remove as dependents of this task. e.g. '111111,222222,333333'

task_gidstringrequiredGlobally unique identifier for the task from which to remove dependents. e.g. 1234567890

asana_task_remove_followers#Remove followers from a task.3 params▾

Remove followers from a task.

NameTypeRequiredDescription

followersstringrequiredComma-separated GIDs of users to remove as followers

task_gidstringrequiredGID of the task

opt_fieldsstringoptionalComma-separated list of optional fields to include in response

asana_task_remove_project#Remove a task from a project.2 params▾

Remove a task from a project.

NameTypeRequiredDescription

projectstringrequiredGID of the project to remove the task from

task_gidstringrequiredGID of the task to remove from a project

asana_task_remove_tag#Remove a tag from a task.2 params▾

Remove a tag from a task.

NameTypeRequiredDescription

tagstringrequiredGID of the tag to remove from the task

task_gidstringrequiredGID of the task

asana_task_search#Search for tasks in a workspace using text and filter criteria.5 params▾

Search for tasks in a workspace using text and filter criteria.

NameTypeRequiredDescription

workspace_gidstringrequiredGID of the workspace to search tasks in

assigneestringoptionalFilter tasks by assignee GID or 'me'

completedbooleanoptionalFilter by task completion status. True returns only completed tasks, false returns only incomplete tasks.

opt_fieldsstringoptionalComma-separated list of optional fields to include in response

textstringoptionalText to search for in task names and descriptions

asana_task_set_parent#Set or change the parent task of a task.5 params▾

Set or change the parent task of a task.

NameTypeRequiredDescription

parentstringrequiredGID of the new parent task. Use null to make it a top-level task.

task_gidstringrequiredGID of the task to set parent for

insert_afterstringoptionalA subtask GID to insert this task after in the parent

insert_beforestringoptionalA subtask GID to insert this task before in the parent

opt_fieldsstringoptionalComma-separated list of optional fields to include in response

asana_task_stories_list#List stories (comments and activity) on a task.2 params▾

List stories (comments and activity) on a task.

NameTypeRequiredDescription

task_gidstringrequiredGID of the task to list stories from

opt_fieldsstringoptionalComma-separated list of optional fields to include in response

asana_task_subtasks_list#List all subtasks of a task.2 params▾

List all subtasks of a task.

NameTypeRequiredDescription

task_gidstringrequiredGID of the parent task

opt_fieldsstringoptionalComma-separated list of optional fields to include in response

asana_task_template_get#Get the details of a single task template by its GID.2 params▾

Get the details of a single task template by its GID.

NameTypeRequiredDescription

task_template_gidstringrequiredGID of the task template to retrieve

opt_fieldsstringoptionalComma-separated list of optional fields to include in the response

asana_task_template_instantiate#Create a new task from a task template. Optionally assign the new task to one or more projects.3 params▾

Create a new task from a task template. Optionally assign the new task to one or more projects.

NameTypeRequiredDescription

namestringrequiredName of the new task to create from the template

task_template_gidstringrequiredGID of the task template to instantiate

projectsstringoptionalComma-separated list of project GIDs to add the new task to

asana_task_templates_list#List task templates for a project.2 params▾

List task templates for a project.

NameTypeRequiredDescription

project_gidstringrequiredGID of the project to filter task templates by

opt_fieldsstringoptionalComma-separated list of optional fields to include in the response

asana_task_time_tracking_entries_list#List all time tracking entries logged on a specific task.2 params▾

List all time tracking entries logged on a specific task.

NameTypeRequiredDescription

task_gidstringrequiredGID of the task whose time tracking entries to list

opt_fieldsstringoptionalComma-separated list of optional fields to include in the response

asana_task_time_tracking_entry_create#Log a new time tracking entry on a task.3 params▾

Log a new time tracking entry on a task.

NameTypeRequiredDescription

duration_minutesintegerrequiredDuration of the time entry in minutes

entered_onstringrequiredDate the time was entered, in ISO 8601 format (YYYY-MM-DD)

task_gidstringrequiredGID of the task to log time on

asana_task_update#Update an existing task's properties.8 params▾

Update an existing task's properties.

NameTypeRequiredDescription

task_gidstringrequiredGID of the task to update

assigneestringoptionalGID of the user to assign, or 'me', or null to unassign

completedbooleanoptionalMark the task as complete or incomplete

due_onstringoptionalDue date for the task (YYYY-MM-DD)

namestringoptionalNew name for the task

notesstringoptionalUpdated description for the task

opt_fieldsstringoptionalComma-separated list of optional fields to include in response

start_onstringoptionalStart date for the task (YYYY-MM-DD)

asana_tasks_list#List tasks filtered by project, section, assignee, or workspace. At least one of project, section, assignee, or workspace_gid is required by the Asana API.6 params▾

List tasks filtered by project, section, assignee, or workspace. At least one of project, section, assignee, or workspace_gid is required by the Asana API.

NameTypeRequiredDescription

assigneestringoptionalGID or 'me' to filter tasks by assignee

completed_sincestringoptionalOnly return tasks completed after this date-time (ISO 8601)

opt_fieldsstringoptionalComma-separated list of optional fields to include in response

projectstringoptionalGID of a project to filter tasks by

sectionstringoptionalGID of a section to filter tasks by

workspace_gidstringoptionalGID of the workspace (required if assignee is set without project)

asana_team_add_user#Add a user to a team.3 params▾

Add a user to a team.

NameTypeRequiredDescription

team_gidstringrequiredGID of the team

userstringrequiredGID of the user to add to the team

opt_fieldsstringoptionalComma-separated list of optional fields to include in response

asana_team_create#Create a new team in an organization.4 params▾

Create a new team in an organization.

NameTypeRequiredDescription

namestringrequiredName of the new team

organization_gidstringrequiredGID of the organization in which to create the team

descriptionstringoptionalOptional description for the team

opt_fieldsstringoptionalComma-separated list of optional fields to include in response

asana_team_get#Get details of a specific team by its GID.2 params▾

Get details of a specific team by its GID.

NameTypeRequiredDescription

team_gidstringrequiredGID of the team to retrieve

opt_fieldsstringoptionalComma-separated list of optional fields to include in response

asana_team_membership_get#Get a single team membership record by its GID.2 params▾

Get a single team membership record by its GID.

NameTypeRequiredDescription

team_membership_gidstringrequiredGID of the team membership to retrieve

opt_fieldsstringoptionalComma-separated list of optional fields to include in the response

asana_team_memberships_list#List team memberships, optionally filtered by team, user, or workspace.4 params▾

List team memberships, optionally filtered by team, user, or workspace.

NameTypeRequiredDescription

opt_fieldsstringoptionalComma-separated list of optional fields to include in the response

team_gidstringoptionalGID of the team to filter memberships by

user_gidstringoptionalGID of the user to filter memberships by

workspace_gidstringoptionalGID of the workspace to filter memberships by

asana_team_projects_list#List all projects for a given team.3 params▾

List all projects for a given team.

NameTypeRequiredDescription

team_gidstringrequiredGID of the team whose projects to list

archivedbooleanoptionalFilter by archived status; true for archived, false for active, null for both

opt_fieldsstringoptionalComma-separated list of optional fields to include in response

asana_team_remove_user#Remove a user from a team.2 params▾

Remove a user from a team.

NameTypeRequiredDescription

team_gidstringrequiredGID of the team

userstringrequiredGID of the user to remove from the team

asana_team_team_memberships_list#List all memberships for a specific team.2 params▾

List all memberships for a specific team.

NameTypeRequiredDescription

team_gidstringrequiredGID of the team whose memberships to list

opt_fieldsstringoptionalComma-separated list of optional fields to include in the response

asana_team_update#Update a team's name or description.4 params▾

Update a team's name or description.

NameTypeRequiredDescription

team_gidstringrequiredGID of the team to update

descriptionstringoptionalNew description for the team

namestringoptionalNew name for the team

opt_fieldsstringoptionalComma-separated list of optional fields to include in response

asana_time_tracking_categories_list#List all time tracking categories available in a given workspace.2 params▾

List all time tracking categories available in a given workspace.

NameTypeRequiredDescription

workspace_gidstringrequiredGID of the workspace whose time tracking categories to list

opt_fieldsstringoptionalComma-separated list of optional fields to include in the response

asana_time_tracking_category_get#Get a single time tracking category by its GID.2 params▾

Get a single time tracking category by its GID.

NameTypeRequiredDescription

time_tracking_category_gidstringrequiredGID of the time tracking category to retrieve

opt_fieldsstringoptionalComma-separated list of optional fields to include in the response

asana_time_tracking_entries_list#List time tracking entries across a workspace, optionally filtered by user.3 params▾

List time tracking entries across a workspace, optionally filtered by user.

NameTypeRequiredDescription

opt_fieldsstringoptionalComma-separated list of optional fields to include in the response

user_gidstringoptionalGID of the user to filter time tracking entries by

workspace_gidstringoptionalGID of the workspace to list time tracking entries from

asana_time_tracking_entry_delete#Permanently delete a time tracking entry.1 param▾

Permanently delete a time tracking entry.

NameTypeRequiredDescription

time_tracking_entry_gidstringrequiredGID of the time tracking entry to delete

asana_time_tracking_entry_get#Get a single time tracking entry by its GID.2 params▾

Get a single time tracking entry by its GID.

NameTypeRequiredDescription

time_tracking_entry_gidstringrequiredGID of the time tracking entry to retrieve

opt_fieldsstringoptionalComma-separated list of optional fields to include in the response

asana_time_tracking_entry_update#Update an existing time tracking entry's duration or date.3 params▾

Update an existing time tracking entry's duration or date.

NameTypeRequiredDescription

time_tracking_entry_gidstringrequiredGID of the time tracking entry to update

duration_minutesintegeroptionalUpdated duration of the time entry in minutes

entered_onstringoptionalUpdated date the time was entered, in ISO 8601 format (YYYY-MM-DD)

asana_typeahead_search#Search for objects in a workspace by name prefix. Returns users, projects, tags, tasks, and portfolios matching the query. Useful for autocomplete and ID lookup.5 params▾

Search for objects in a workspace by name prefix. Returns users, projects, tags, tasks, and portfolios matching the query. Useful for autocomplete and ID lookup.

NameTypeRequiredDescription

querystringrequiredName prefix to search for

workspace_gidstringrequiredGID of the workspace to search within

countintegeroptionalMaximum number of results to return (1-20)

opt_fieldsstringoptionalComma-separated list of optional fields to include in response

resource_typestringoptionalType of resource to filter results by

asana_user_favorites_list#List a user's favorited objects in a workspace in Asana. Optionally filter by resource type.4 params▾

List a user's favorited objects in a workspace in Asana. Optionally filter by resource type.

NameTypeRequiredDescription

resource_typestringrequiredFilter favorites by resource type

user_gidstringrequiredGID of the user whose favorites to list

workspace_gidstringrequiredGID of the workspace to scope the favorites

opt_fieldsstringoptionalComma-separated list of optional fields to include in response

asana_user_get#Get the profile of a specific user by GID.2 params▾

Get the profile of a specific user by GID.

NameTypeRequiredDescription

user_gidstringrequiredGID of the user. Use 'me' for the authenticated user.

opt_fieldsstringoptionalComma-separated list of optional fields to include in response

asana_user_task_list_for_user_get#Get the personal task list for a user in a workspace in Asana.3 params▾

Get the personal task list for a user in a workspace in Asana.

NameTypeRequiredDescription

user_gidstringrequiredGID of the user whose task list to retrieve

workspace_gidstringrequiredGID of the workspace to scope the request

opt_fieldsstringoptionalComma-separated list of optional fields to include in response

asana_user_task_list_get#Get a user task list by its GID in Asana.2 params▾

Get a user task list by its GID in Asana.

NameTypeRequiredDescription

user_task_list_gidstringrequiredGID of the user task list to retrieve

opt_fieldsstringoptionalComma-separated list of optional fields to include in response

asana_user_team_memberships_list#List all team memberships for a specific user.3 params▾

List all team memberships for a specific user.

NameTypeRequiredDescription

user_gidstringrequiredGID of the user whose team memberships to list

opt_fieldsstringoptionalComma-separated list of optional fields to include in the response

workspace_gidstringoptionalGID of the workspace to filter memberships by

asana_user_teams_list#List all teams a user belongs to.3 params▾

List all teams a user belongs to.

NameTypeRequiredDescription

user_gidstringrequiredGID of the user whose teams to list, or 'me' for the current user

opt_fieldsstringoptionalComma-separated list of optional fields to include in response

organization_gidstringoptionalGID of the organization to filter teams by

asana_user_workspace_memberships_list#List all workspace memberships for a specific user. Returns membership records showing which workspaces the user belongs to and their role in each.2 params▾

List all workspace memberships for a specific user. Returns membership records showing which workspaces the user belongs to and their role in each.

NameTypeRequiredDescription

user_gidstringrequiredGlobally unique identifier for the user whose workspace memberships to list. e.g. 987654321

opt_fieldsstringoptionalComma-separated list of optional fields to include in the response. e.g. workspace,workspace.name,is_active

asana_users_list#List users in a workspace.2 params▾

List users in a workspace.

NameTypeRequiredDescription

workspace_gidstringrequiredGID of the workspace to list users from

opt_fieldsstringoptionalComma-separated list of optional fields to include in response

asana_webhook_create#Create a webhook to receive event notifications for a resource.3 params▾

Create a webhook to receive event notifications for a resource.

NameTypeRequiredDescription

resource_gidstringrequiredGID of the resource to watch for events

target_urlstringrequiredHTTPS URL that will receive event notifications

filtersarrayoptionalArray of filter objects to narrow which events trigger the webhook

asana_webhook_delete#Permanently delete a webhook. The webhook will no longer receive event notifications.1 param▾

Permanently delete a webhook. The webhook will no longer receive event notifications.

NameTypeRequiredDescription

webhook_gidstringrequiredThe GID of the webhook to delete

asana_webhook_get#Get a webhook by its GID.2 params▾

Get a webhook by its GID.

NameTypeRequiredDescription

webhook_gidstringrequiredThe GID of the webhook to retrieve

opt_fieldsstringoptionalComma-separated list of optional fields to include in response

asana_webhook_update#Update the filters on an existing webhook.2 params▾

Update the filters on an existing webhook.

NameTypeRequiredDescription

webhook_gidstringrequiredThe GID of the webhook to update

filtersarrayoptionalArray of filter objects to replace the webhook's existing filters

asana_webhooks_list#List all webhooks for a workspace.3 params▾

List all webhooks for a workspace.

NameTypeRequiredDescription

workspace_gidstringrequiredGID of the workspace to list webhooks for

opt_fieldsstringoptionalComma-separated list of optional fields to include in response

resourcestringoptionalGID of a resource to filter webhooks by

asana_workspace_add_user#Add a user to a workspace or organization in Asana.2 params▾

Add a user to a workspace or organization in Asana.

NameTypeRequiredDescription

user_gidstringrequiredGID or email of the user to add to the workspace

workspace_gidstringrequiredGID of the workspace to add the user to

asana_workspace_custom_fields_list#List all custom fields in a workspace.2 params▾

List all custom fields in a workspace.

NameTypeRequiredDescription

workspace_gidstringrequiredGID of the workspace to list custom fields for

opt_fieldsstringoptionalComma-separated list of optional fields to include in response

asana_workspace_get#Get details of a specific workspace by its GID.2 params▾

Get details of a specific workspace by its GID.

NameTypeRequiredDescription

workspace_gidstringrequiredGID of the workspace to retrieve

opt_fieldsstringoptionalComma-separated list of optional fields to include in response

asana_workspace_membership_get#Get a specific workspace membership record by its GID. Returns user identity and workspace-level role details for that membership.2 params▾

Get a specific workspace membership record by its GID. Returns user identity and workspace-level role details for that membership.

NameTypeRequiredDescription

workspace_membership_gidstringrequiredGlobally unique identifier for the workspace membership record to retrieve. e.g. 1234567890

opt_fieldsstringoptionalComma-separated list of optional fields to include in the response. e.g. user,user.name,workspace,is_active

asana_workspace_memberships_list#List all members of a workspace. Returns membership records for all users in the specified workspace including their roles and status.2 params▾

List all members of a workspace. Returns membership records for all users in the specified workspace including their roles and status.

NameTypeRequiredDescription

workspace_gidstringrequiredGlobally unique identifier for the workspace whose members to list. e.g. 1234567890

opt_fieldsstringoptionalComma-separated list of optional fields to include in the response. e.g. user,user.name,is_active

asana_workspace_remove_user#Remove a user from a workspace or organization in Asana.2 params▾

Remove a user from a workspace or organization in Asana.

NameTypeRequiredDescription

user_gidstringrequiredGID of the user to remove from the workspace

workspace_gidstringrequiredGID of the workspace to remove the user from

asana_workspace_teams_list#List all teams in a workspace.2 params▾

List all teams in a workspace.

NameTypeRequiredDescription

workspace_gidstringrequiredGID of the workspace

opt_fieldsstringoptionalComma-separated list of optional fields to include in response

asana_workspace_user_get#Get a user's workspace-level membership details. Returns the user's profile and role information within the specified workspace.3 params▾

Get a user's workspace-level membership details. Returns the user's profile and role information within the specified workspace.

NameTypeRequiredDescription

user_gidstringrequiredGlobally unique identifier for the user to look up in the workspace. e.g. 987654321

workspace_gidstringrequiredGlobally unique identifier for the workspace. e.g. 1234567890

opt_fieldsstringoptionalComma-separated list of optional fields to include in the response. e.g. name,email,workspaces

asana_workspaces_list#List all workspaces the authenticated user has access to.1 param▾

List all workspaces the authenticated user has access to.

NameTypeRequiredDescription

opt_fieldsstringoptionalComma-separated list of optional fields to include in response