Skip to Content

Asana API

Asana API icon
Arcade Starter

Tools that enable LLMs to interact directly with the Asana API.

Author:Arcade
Version:1.0.0
Auth:User authorization via the Asana auth provider
199tools
PyPI VersionPython VersionsWheel StatusDownloadsLicense

AsanaApi is a toolkit that enables integration with the Asana API, allowing LLMs to manage tasks, projects, goals, and custom fields effectively.

Capabilities:

  • Create, update, delete, and retrieve records for tasks, projects, goals, and custom fields.
  • Manage task dependencies and followers with ease.
  • Retrieve detailed information about various entities, including custom field settings.
  • Utilize asynchronous operations for project instantiation and exports.
  • Efficiently handle permissions and access requests across the workspace.

OAuth: Provider: Asana
Scopes: attachments:delete, attachments:read, custom_fields:read, custom_fields:write, goals:read, portfolios:read, portfolios:write, projects:delete, projects:read, projects:write, tasks:read, tasks:write, users:read, webhooks:read, webhooks:write.

Secrets: No secrets are required for using this toolkit.

Available tools(199)

199 of 199
Tool nameDescriptionSecrets
Create a new task in Asana. Use this tool to create a new task in a specified Asana workspace. You can set various fields on the task upon creation. It is required to specify a workspace, which cannot be changed later, unless specified through projects or a parent task. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires query parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required query parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.
Add a custom field setting to a project in Asana. Use this tool to associate a custom field with a specific project in Asana. This operation requires the 'projects:write' scope. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires path, query parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required path, query parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.
Add a custom field setting to an Asana portfolio. Use this tool to associate a custom field with a specific portfolio in Asana. This requires portfolios:write access scope. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires path, query parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required path, query parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.
Add dependents to an Asana task. Use this tool to mark a set of Asana tasks as dependents of another task, ensuring they are not already listed. Suitable for cases where task dependencies are being managed and a task can have up to 30 dependents and dependencies combined.
Add an enum option to a custom field in Asana. This tool adds a new enum option to a custom field in Asana, updating the list of enum options. Use this when managing custom fields and needing to expand the choices available. Requires 'custom_fields:write' scope. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires path, query parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required path, query parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.
Add followers to a specific goal in Asana. Use this tool to add followers to a specific goal in Asana. It returns the updated goal details after successfully adding the followers.
Add specified users as followers to an Asana project. This tool adds a list of users as followers to a specified project in Asana. Followers receive "tasks added" notifications and are made members of the project if they aren't already. Use this when needing to update project followers.
Adds followers to an Asana task. Use this tool to add one or more followers to a specific task in Asana. The request will return the updated task record, reflecting the changes.
Add an item to a portfolio in Asana. Use this tool to add an item to a specified portfolio in Asana. Requires 'portfolios:write' permission.
Add specified users as members of a project in Asana. Use this tool to add users as members of a specific project. This may also add users as followers depending on their notification settings.
Add specified users as members of a portfolio on Asana. Use this tool to add a list of users as members to a specific portfolio in Asana. This returns the updated portfolio record with the new members included.
Add a tag to a specific Asana task. This tool adds a tag to a specified task in Asana. It should be used when you need to organize tasks by attaching tags. Requires 'tasks:write' scope.
Add a comment to a specific task in Asana. This tool adds a comment to a task in Asana, authored by the authenticated user, and returns the full record of the newly created comment. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires path, query parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required path, query parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.
Add dependencies to an Asana task. Marks specified tasks as dependencies for a given task in Asana, ensuring they aren't already marked. Suitable for managing task workflows where completion order is essential.
Add a task to a specified Asana project. Use this to add a task to a specific project within Asana, optionally specifying the location. It can also reorder a task within a project. Only one of `insert_before`, `insert_after`, or `section` should be used to specify the location. Tasks can be associated with up to 20 projects.
Add a task to a specified section in Asana. Use this tool to add a task to a specific, existing section in an Asana project. The task will be positioned at the top unless specified otherwise, and will be removed from other sections in the project. It cannot be used to add separators.
Adds a user to a specified team on Asana. This tool should be called when you need to add an existing user to an Asana team. The caller must be a member of the team and the user being added must belong to the same organization as the team.
Add a user to an Asana workspace or organization. Use this tool to add a user to an Asana workspace. The user can be specified by their unique user ID or email. It returns the complete user record of the invited user.
Approves an access request for a target object in Asana. Use this tool to approve an access request for a specific target object in Asana. It should be called when a user needs to grant access to a specified request.
Create a team in your current Asana workspace. This tool is used to create a new team within the specified Asana workspace. It should be called when you need to organize a group of projects or tasks under a new team entity. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires query parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required query parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.
Initiate duplication of a project in Asana. Creates and returns a job to handle the asynchronous duplication of a project in Asana. It requires 'projects:write' scope.
Remove followers from an Asana task. This tool removes specified followers from a given Asana task and returns the complete, updated task record. It should be called when you need to update a task by removing certain users as followers. Requires 'tasks:write' scope.
Update filters for an Asana webhook. Use this tool to update the filters of an existing Asana webhook by providing new filter specifications. The existing filters will be completely replaced with the new ones provided. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires path, query parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required path, query parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.
Creates a new allocation in Asana and returns its details. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires query parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required query parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.
Create a new goal in Asana workspace or team. This tool is used to create a new goal in an Asana workspace or team. It returns the full record of the newly created goal, making it essential for managing and tracking team objectives within Asana. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires query parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required query parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.
Page 1 of 8(25 of 199)

Selected tools

No tools selected.

Click "Show all tools" to add tools.

Requirements

Select tools to see requirements

#

AsanaApi.AddAsanaTask

Create a new task in Asana. Use this tool to create a new task in a specified Asana workspace. You can set various fields on the task upon creation. It is required to specify a workspace, which cannot be changed later, unless specified through projects or a parent task. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires query parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required query parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
include_optional_fieldsarray<string>OptionalComma-separated list of optional task properties to include in the response. Excludes some properties by default. Only used when mode is 'execute'.
enable_pretty_outputbooleanOptionalEnable to receive the response in a readable format with line breaks and indentation. Use for debugging as it increases response time and size. Only used when mode is 'execute'.
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'createTask'.
#

AsanaApi.AddCustomFieldSettingToProject

Add a custom field setting to a project in Asana. Use this tool to associate a custom field with a specific project in Asana. This operation requires the 'projects:write' scope. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires path, query parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required path, query parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
project_global_idstringOptionalGlobally unique identifier for the project in Asana. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
include_optional_propertiesarray<string>OptionalComma-separated list of properties to include in the response, typically those excluded by default. Only used when mode is 'execute'.
enable_pretty_outputbooleanOptionalSet to true for a readable output format with line breaks and indentation. Increases response time and size, so use it mainly for debugging. Only used when mode is 'execute'.
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'addCustomFieldSettingForProject'.
#

AsanaApi.AddCustomFieldToPortfolio

Add a custom field setting to an Asana portfolio. Use this tool to associate a custom field with a specific portfolio in Asana. This requires portfolios:write access scope. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires path, query parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required path, query parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
portfolio_identifierstringOptionalGlobally unique identifier for the portfolio to which the custom field will be added. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
pretty_formatting_enabledbooleanOptionalSet to true to format the response for better readability, useful for debugging. Only used when mode is 'execute'.
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'addCustomFieldSettingForPortfolio'.
#

AsanaApi.AddDependentsToTask

Add dependents to an Asana task. Use this tool to mark a set of Asana tasks as dependents of another task, ensuring they are not already listed. Suitable for cases where task dependencies are being managed and a task can have up to 30 dependents and dependencies combined.

Parameters

ParameterTypeReq.Description
target_task_idstringRequiredThe unique identifier for the task to add dependents to.
dependent_task_gidsarray<string>OptionalAn array of task GIDs to be marked as dependents for this task.
enable_pretty_outputbooleanOptionalSet to true to format the response for readability. Use during debugging, as it increases response time and size.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'addDependentsForTask'.
#

AsanaApi.AddEnumOptionToCustomField

Add an enum option to a custom field in Asana. This tool adds a new enum option to a custom field in Asana, updating the list of enum options. Use this when managing custom fields and needing to expand the choices available. Requires 'custom_fields:write' scope. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires path, query parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required path, query parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
custom_field_identifierstringOptionalGlobally unique identifier for the custom field in Asana. Use this to specify the field you want to modify. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
include_optional_propertiesarray<string>OptionalList of properties to include in the response that are excluded by default. Provide these as an array of strings. Only used when mode is 'execute'.
enable_pretty_outputbooleanOptionalEnable to receive a readable JSON response with line breaks and indentation. Use primarily for debugging as it increases response size and time. Only used when mode is 'execute'.
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'createEnumOptionForCustomField'.
#

AsanaApi.AddFollowersToGoal

Add followers to a specific goal in Asana. Use this tool to add followers to a specific goal in Asana. It returns the updated goal details after successfully adding the followers.

Parameters

ParameterTypeReq.Description
goal_unique_idstringRequiredGlobally unique identifier for the goal to which you want to add followers.
enable_pretty_outputbooleanOptionalSet to true to receive the response in a human-readable format with proper indentation and line breaks. Useful for debugging but increases response size and time.
optional_properties_to_includearray<string>OptionalComma-separated list of optional properties to include in the response for additional details.
user_identifiers_arrayarray<string>OptionalAn array of user identifiers to add as followers. These can be 'me', emails, or user gids.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'addFollowers'.
#

AsanaApi.AddFollowersToProject

Add specified users as followers to an Asana project. This tool adds a list of users as followers to a specified project in Asana. Followers receive "tasks added" notifications and are made members of the project if they aren't already. Use this when needing to update project followers.

Parameters

ParameterTypeReq.Description
project_unique_idstringRequiredGlobally unique identifier for the project to which followers will be added.
enable_pretty_outputbooleanOptionalEnable pretty JSON output for readability, useful for debugging. May slow responses.
optional_fields_to_includearray<string>OptionalComma-separated list of optional properties to include in the response to enrich data output.
user_identifiers_to_add_as_followersstringOptionalAn array of user identifiers to add as followers. Accepts 'me', email addresses, or user gids.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'addFollowersForProject'.
#

AsanaApi.AddFollowersToTask

Adds followers to an Asana task. Use this tool to add one or more followers to a specific task in Asana. The request will return the updated task record, reflecting the changes.

Parameters

ParameterTypeReq.Description
task_gidstringRequiredThe unique identifier of the task to add followers to. This is required to specify which task the followers should be added to.
enable_pretty_outputbooleanOptionalEnables pretty formatting for the response, adding line breaks and indentation. Useful for debugging but increases response size.
followers_identificationarray<string>OptionalAn array of strings identifying users, which can be 'me', an email, or a user gid.
include_optional_propertiesarray<string>OptionalComma-separated list of optional task properties to include in the response.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'addFollowersForTask'.
#

AsanaApi.AddItemToPortfolio

Add an item to a portfolio in Asana. Use this tool to add an item to a specified portfolio in Asana. Requires 'portfolios:write' permission.

Parameters

ParameterTypeReq.Description
portfolio_unique_idstringRequiredGlobally unique identifier for the portfolio to which the item will be added.
add_after_item_idstringOptionalID of an item in the portfolio where the new item will be added after. Cannot be used with 'add_before_item_id'.
enable_pretty_outputbooleanOptionalEnable pretty JSON formatting for debugging. This increases response size and processing time.
insert_item_before_idstringOptionalID of an existing portfolio item. The new item will be placed before this item. Cannot be used with `insert_after_id`.
item_to_add_to_portfoliostringOptionalThe ID of the item to be added to the Asana portfolio.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'addItemForPortfolio'.
#

AsanaApi.AddMembersToProject

Add specified users as members of a project in Asana. Use this tool to add users as members of a specific project. This may also add users as followers depending on their notification settings.

Parameters

ParameterTypeReq.Description
project_unique_identifierstringRequiredGlobally unique identifier for the project in Asana.
include_optional_propertiesarray<string>OptionalA comma-separated list of optional properties to include in the response. This adds excluded properties by default.
pretty_outputbooleanOptionalIf true, the response is formatted with line breaks and indentation for readability. Use mainly for debugging.
user_identifiers_arraystringOptionalAn array of strings identifying users to be added to the project. Values can be 'me', an email, or a user GID.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'addMembersForProject'.
#

AsanaApi.AddPortfolioMembers

Add specified users as members of a portfolio on Asana. Use this tool to add a list of users as members to a specific portfolio in Asana. This returns the updated portfolio record with the new members included.

Parameters

ParameterTypeReq.Description
portfolio_global_idstringRequiredGlobally unique identifier for the portfolio to which members will be added.
enable_pretty_outputbooleanOptionalSet to true for readable line-breaking and indentation in the response. Use for debugging as it increases response size and time.
include_optional_propertiesarray<string>OptionalA list of optional properties to include in the response, provided as an array of strings.
portfolio_member_identifiersstringOptionalAn array of strings identifying users to add. Use 'me', an email, or user gid.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'addMembersForPortfolio'.
#

AsanaApi.AddTagToTask

Add a tag to a specific Asana task. This tool adds a tag to a specified task in Asana. It should be used when you need to organize tasks by attaching tags. Requires 'tasks:write' scope.

Parameters

ParameterTypeReq.Description
task_idstringRequiredThe unique identifier of the task to which the tag should be added.
enable_pretty_outputbooleanOptionalEnable this to receive a prettified JSON response. Useful for debugging, but increases response time and size.
tag_gid_to_addstringOptionalThe GID of the tag to be added to the specified task.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'addTagForTask'.
#

AsanaApi.AddTaskComment

Add a comment to a specific task in Asana. This tool adds a comment to a task in Asana, authored by the authenticated user, and returns the full record of the newly created comment. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires path, query parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required path, query parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
target_task_idstringOptionalThe ID of the task to which the comment will be added. It is required to specify the task you want to operate on. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
include_optional_propertiesarray<string>OptionalComma-separated list of optional properties to include in the response, as the endpoint excludes some by default. Only used when mode is 'execute'.
enable_pretty_outputbooleanOptionalFormats the response for readability with line breaks and indentation when true. Recommended for debugging due to extra processing time. Only used when mode is 'execute'.
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'createStoryForTask'.
#

AsanaApi.AddTaskDependencies

Add dependencies to an Asana task. Marks specified tasks as dependencies for a given task in Asana, ensuring they aren't already marked. Suitable for managing task workflows where completion order is essential.

Parameters

ParameterTypeReq.Description
task_id_to_modifystringRequiredThe unique identifier of the task to which dependencies will be added.
enable_pretty_outputbooleanOptionalEnable pretty formatting for the response output. Provides improved readability with line breaking and indentation, recommended for debugging only.
task_dependency_idsarray<string>OptionalAn array of task GIDs that the current task depends on. These are required to establish dependencies between tasks in Asana.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'addDependenciesForTask'.
#

AsanaApi.AddTaskToProject

Add a task to a specified Asana project. Use this to add a task to a specific project within Asana, optionally specifying the location. It can also reorder a task within a project. Only one of `insert_before`, `insert_after`, or `section` should be used to specify the location. Tasks can be associated with up to 20 projects.

Parameters

ParameterTypeReq.Description
task_global_idstringRequiredThe unique global ID of the task to be operated on.
enable_pretty_outputbooleanOptionalSet to true for formatted JSON output, making it more readable. Useful for debugging. Note: This increases response time and size.
insert_after_task_idstringOptionalProvide the ID of a task in the project to insert this task after, or use 'null' to insert at the beginning.
insert_task_beforestringOptionalSpecify a task ID to insert the new task before it in the project, or use `null` to insert at the end of the list.
project_id_to_add_taskstringOptionalThe unique identifier of the project to which the task will be added.
target_section_idstringOptionalThe ID of the section in the project to insert the task at the bottom.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'addProjectForTask'.
#

AsanaApi.AddTaskToSection

Add a task to a specified section in Asana. Use this tool to add a task to a specific, existing section in an Asana project. The task will be positioned at the top unless specified otherwise, and will be removed from other sections in the project. It cannot be used to add separators.

Parameters

ParameterTypeReq.Description
section_global_identifierstringRequiredThe globally unique identifier for the section where the task will be added.
enable_pretty_outputbooleanOptionalEnable pretty formatting for the API response, with line breaks and indentation for readability. Use mainly for debugging.
insert_after_task_idstringOptionalSpecify the task ID after which the new task should be inserted within the section. Cannot be used with insert_before.
insert_task_beforestringOptionalThe ID of an existing task in the section to insert the new task before. Cannot be used with insert_task_after.
task_descriptionstringOptionalThe name or description of the task to be added to the specified section.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'addTaskForSection'.
#

AsanaApi.AddUserToTeam

Adds a user to a specified team on Asana. This tool should be called when you need to add an existing user to an Asana team. The caller must be a member of the team and the user being added must belong to the same organization as the team.

Parameters

ParameterTypeReq.Description
team_unique_identifierstringRequiredGlobally unique identifier for the team to which the user is being added.
enable_pretty_outputbooleanOptionalSet to true for a readable response format with line breaks and indentation. Use mainly for debugging due to increased response time and size.
include_optional_propertiesarray<string>OptionalComma-separated list of properties to include in the response, which are excluded by default.
user_identifierstringOptionalIdentifies the user to add. Use "me", an email, or the user's global ID (gid).

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'addUserForTeam'.
#

AsanaApi.AddUserToWorkspace

Add a user to an Asana workspace or organization. Use this tool to add a user to an Asana workspace. The user can be specified by their unique user ID or email. It returns the complete user record of the invited user.

Parameters

ParameterTypeReq.Description
workspace_global_identifierstringRequiredGlobally unique identifier for the workspace or organization in Asana.
enable_pretty_outputbooleanOptionalEnable this to receive the response in a readable JSON format with line breaks and indentation. This is useful for debugging but can increase response time and size.
include_optional_fieldsarray<string>OptionalComma-separated list of optional properties to include in the response.
user_identifierstringOptionalA string identifying a user. Can be "me", an email, or a user ID (gid).

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'addUserForWorkspace'.
#

AsanaApi.ApproveAccessRequest

Approves an access request for a target object in Asana. Use this tool to approve an access request for a specific target object in Asana. It should be called when a user needs to grant access to a specified request.

Parameters

ParameterTypeReq.Description
access_request_global_idstringRequiredGlobally unique identifier for the specific access request to approve.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'approveAccessRequest'.
#

AsanaApi.AsanaCreateTeam

Create a team in your current Asana workspace. This tool is used to create a new team within the specified Asana workspace. It should be called when you need to organize a group of projects or tasks under a new team entity. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires query parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required query parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
include_optional_propertiesarray<string>OptionalComma-separated list of optional properties to include in the response, enhancing the returned team's details. Only used when mode is 'execute'.
pretty_output_enabledbooleanOptionalSet to true to receive pretty, human-readable output with line breaks and indentation. Use for debugging. Only used when mode is 'execute'.
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'createTeam'.
#

AsanaApi.AsanaDuplicateProject

Initiate duplication of a project in Asana. Creates and returns a job to handle the asynchronous duplication of a project in Asana. It requires 'projects:write' scope.

Parameters

ParameterTypeReq.Description
project_global_idstringRequiredGlobally unique identifier for the project to be duplicated.
include_elements_in_project_duplicationstringOptionalA comma-separated list of optional elements to include when duplicating a project. Some elements are auto-included and cannot be excluded.
include_optional_fieldsarray<string>OptionalComma-separated list of optional properties to include in the response, such as additional project details.
last_due_date_in_duplicated_projectstringOptionalSets the last due date in the duplicated project. The subsequent due dates will be offset similarly to the original project.
new_project_namestringOptionalThe name for the duplicated project in Asana.
new_project_team_idstringOptionalGlobally unique identifier for the team to set for the new project. If not provided, the project will remain in the same team as the original.
pretty_output_enabledbooleanOptionalEnable pretty formatting for the response output. Useful for debugging but increases response size and time.
skip_weekends_in_schedulebooleanOptionalSet to true to skip weekends for auto-shifted dates in the duplicated project schedule. This is a required parameter.
start_date_for_first_taskstringOptionalSets the first start date in the duplicated project. Adjusts other start dates based on this.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'duplicateProject'.
#

AsanaApi.AsanaRemoveFollowerForTask

Remove followers from an Asana task. This tool removes specified followers from a given Asana task and returns the complete, updated task record. It should be called when you need to update a task by removing certain users as followers. Requires 'tasks:write' scope.

Parameters

ParameterTypeReq.Description
task_idstringRequiredThe unique identifier of the task from which followers are to be removed.
enable_pretty_outputbooleanOptionalSet to true for readable JSON with line breaks and indentation. Use for debugging; increases response size and processing time.
followers_to_removearray<string>OptionalAn array of strings identifying users to remove as followers. Acceptable formats: "me", an email, or a user's gid.
include_optional_propertiesarray<string>OptionalA list of optional task properties to include in the response. Specify as an array of strings.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'removeFollowerForTask'.
#

AsanaApi.AsanaUpdateWebhookFilters

Update filters for an Asana webhook. Use this tool to update the filters of an existing Asana webhook by providing new filter specifications. The existing filters will be completely replaced with the new ones provided. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires path, query parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required path, query parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
webhook_global_idstringOptionalGlobally unique identifier for the webhook to update its filters. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
include_optional_propertiesarray<string>OptionalComma-separated list of optional properties to include in the response. Only used when mode is 'execute'.
enable_pretty_outputbooleanOptionalEnable this to receive the response in a human-readable format with line breaking and indentation. Recommended only for debugging as it increases response size and time. Only used when mode is 'execute'.
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'updateWebhook'.
#

AsanaApi.CreateAllocation

Creates a new allocation in Asana and returns its details. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires query parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required query parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
optional_properties_to_includearray<string>OptionalList the properties to include that are not included by default in the allocation resource response. Provide as an array of strings. Only used when mode is 'execute'.
enable_pretty_outputbooleanOptionalEnable pretty formatting for the response to improve readability with line breaks and indentation. Recommended only for debugging due to increased response time and size. Only used when mode is 'execute'.
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'createAllocation'.
#

AsanaApi.CreateAsanaGoal

Create a new goal in Asana workspace or team. This tool is used to create a new goal in an Asana workspace or team. It returns the full record of the newly created goal, making it essential for managing and tracking team objectives within Asana. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires query parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required query parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
include_optional_propertiesarray<string>OptionalComma-separated list of optional properties to include in the response for a more comprehensive goal record. Only used when mode is 'execute'.
enable_pretty_outputbooleanOptionalEnables pretty formatting for the API response, useful for debugging. Increases response time and size. Only used when mode is 'execute'.
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'createGoal'.
#

AsanaApi.CreateAsanaMembership

Create a new membership in Asana for goals, projects, portfolios, or custom fields. This tool creates a new membership in a specified Asana entity, such as a goal, project, portfolio, or custom field. It is used to add teams or users as members and returns the complete record of the newly created membership. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires query parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required query parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
enable_pretty_outputbooleanOptionalIf true, returns the response in a formatted JSON with line breaks and indentation. Recommended only for debugging, as it increases response size and processing time. Only used when mode is 'execute'.
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'createMembership'.
#

AsanaApi.CreateAsanaPortfolio

Create a new portfolio in an Asana workspace. Use this tool to create a new portfolio in a specific Asana workspace with a supplied name. Note that this API does not automatically add states like 'Priority' that might be present in portfolios created through the Asana UI. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires query parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required query parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
include_optional_fieldsarray<string>OptionalList the optional properties to include in the response, such as ['name', 'members']. Only used when mode is 'execute'.
enable_pretty_outputbooleanOptionalIf true, formats the response with line breaks and indentation for easier readability. Recommended for debugging as it may increase response size and time. Only used when mode is 'execute'.
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'createPortfolio'.
#

AsanaApi.CreateAsanaProjectForTeam

Create a new Asana project for a specific team. This tool creates a new project within a specified team on Asana and returns the full record of the created project. It requires a 'projects:write' scope. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires path, query parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required path, query parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
team_global_idstringOptionalGlobally unique identifier for the team in Asana. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
include_optional_project_propertiesarray<string>OptionalSpecify properties to include as a comma-separated list to get additional project details. Only used when mode is 'execute'.
enable_pretty_outputbooleanOptionalSet to true for readable output with line breaks and indentation. Recommended for debugging due to increased response size. Only used when mode is 'execute'.
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'createProjectForTeam'.
#

AsanaApi.CreateAsanaTask

Create and initiate an Asana task asynchronously. This tool creates a job to instantiate a task in Asana using a specified task template. It should be called when you want to initiate a task based on a template, resulting in the creation of an asynchronous job that returns the job details.

Parameters

ParameterTypeReq.Description
task_template_idstringRequiredGlobally unique identifier for the task template used to create the task.
enable_pretty_outputbooleanOptionalEnable 'pretty' formatting of the response for better readability. Useful for debugging but may increase response time and size.
include_optional_propertiesarray<string>OptionalList of optional properties to include in the task resource, comma-separated.
task_namestringOptionalThe name of the new task to be created. If not provided, the task template name will be used by default.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'instantiateTask'.
#

AsanaApi.CreateAsanaWebhook

Initiates the creation of a webhook in Asana. This tool initiates the creation of a webhook in Asana and requires the 'webhooks:write' scope. It involves a confirmation handshake for setup. Ensure your server can handle asynchronous requests to acknowledge the handshake for successful creation. Invalid hostnames like localhost are not allowed. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires query parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required query parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
include_optional_propertiesarray<string>OptionalSpecify properties to include in the response. Provide a list of property names to include those optional properties in the response. Only used when mode is 'execute'.
enable_pretty_outputbooleanOptionalIf true, provides the response in a pretty format with line breaks and indentation. Use it for debugging as it increases response time and size. Only used when mode is 'execute'.
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'createWebhook'.
#

AsanaApi.CreateCustomFieldInWorkspace

Create a new custom field in an Asana workspace. Use this tool to create a custom field in a specific Asana workspace. The field's name must be unique and the type can be text, enum, multi_enum, number, date, or people. The workspace cannot be changed once set. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires query parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required query parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
include_optional_propertiesarray<string>OptionalA list of optional property names to include in the response. Ensure these do not conflict with defaults. Only used when mode is 'execute'.
enable_pretty_outputbooleanOptionalSet to true to receive a JSON response with line breaks and indentation for better readability, mainly for debugging purposes. Only used when mode is 'execute'.
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'createCustomField'.
#

AsanaApi.CreateGoalMetric

Create and add a goal metric to a specific goal. Use this tool to create and add a metric to a specified goal in Asana. It replaces an existing goal metric if one already exists. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires path, query parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required path, query parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
goal_global_idstringOptionalGlobally unique identifier for the goal to which the metric will be added. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
include_optional_propertiesarray<string>OptionalSpecify the optional properties to include in the response as a list of strings. Only used when mode is 'execute'.
enable_pretty_outputbooleanOptionalSet to true for formatted, human-readable output in JSON. Ideal for debugging. May increase response time and size. Only used when mode is 'execute'.
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'createGoalMetric'.
#

AsanaApi.CreateGoalSupportingRelationship

Add a supporting resource to a specific goal in Asana. Use this tool to create a relationship between a goal and a supporting resource in Asana by specifying the goal ID. This tool is useful when you need to associate additional resources with an existing goal.

Parameters

ParameterTypeReq.Description
goal_global_identifierstringRequiredGlobally unique identifier for the goal to which a supporting resource will be added.
enable_pretty_outputbooleanOptionalEnable to receive the response in a formatted and indented manner for easier readability. Recommended for debugging purposes as it increases response time and size.
include_optional_fieldsarray<string>OptionalComma-separated list of optional resource properties to include in the response.
insert_after_subgoal_idstringOptionalID of the subgoal to insert the new subgoal after. Cannot use with `insert_before`. Only for subgoal addition.
insert_subgoal_before_idstringOptionalThe ID of an existing subgoal. The new subgoal will be placed before this subgoal. Cannot be used with `insert_after_subgoal_id`. Only for adding subgoals.
supporting_goal_contribution_weightintegerOptionalA number between 0 and 1 indicating the supporting goal's contribution to the parent goal's progress. Defaults to 0.
supporting_resource_idstringOptionalThe GID of the supporting resource to add to the parent goal. It must be the GID of a goal, project, task, or portfolio.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'addSupportingRelationship'.
#

AsanaApi.CreateNewAsanaProject

Create a new project in an Asana workspace or team. This tool creates a new project in a specified workspace or team within Asana. It is essential to specify the workspace, and if applicable, the team, especially when the workspace is an organization. Once set, these cannot be changed. Use this tool to organize tasks and initiatives within Asana projects. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires query parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required query parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
included_properties_listarray<string>OptionalList of properties to include in the response. Specify as a comma-separated list to include optional fields that are excluded by default. Only used when mode is 'execute'.
enable_pretty_outputbooleanOptionalSet to true for readable JSON formatting with indents and line breaks. This is useful for debugging but increases response size and time. Only used when mode is 'execute'.
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'createProject'.
#

AsanaApi.CreateNewAsanaTag

Create a new tag in an Asana workspace or organization. This tool should be called when there's a need to create a new tag within a specific Asana workspace or organization. It requires the 'tags:write' scope and returns the full record of the newly created tag. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires query parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required query parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
include_optional_propertiesarray<string>OptionalSpecify optional properties to include in the response as a list of strings. These properties are excluded by default. Only used when mode is 'execute'.
pretty_output_enabledbooleanOptionalSet to true for a well-indented, readable response format. Recommend use only for debugging due to increased response size and time. Only used when mode is 'execute'.
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'createTag'.
#

AsanaApi.CreateParallelRequestsAsana

Execute multiple requests to Asana's API simultaneously. Use this tool to make parallel requests to Asana's API efficiently, allowing multiple operations to be executed at once. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires query parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required query parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
include_optional_fieldsarray<string>OptionalA list of optional properties to include in the response. Provide as an array of strings. Only used when mode is 'execute'.
enable_pretty_outputbooleanOptionalEnable pretty output format with line breaks and indentation. Useful for debugging but may increase response size and time. Only used when mode is 'execute'.
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'createBatchRequest'.
#

AsanaApi.CreateProjectBrief

Create a new project brief in Asana. Use this tool to create and initialize a new project brief within a specified Asana project. It returns the full details of the project brief after creation. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires path, query parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required path, query parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
project_global_idstringOptionalGlobally unique identifier for the project in which the brief will be created. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
include_optional_propertiesarray<string>OptionalList of properties to include that are excluded by default in the response. Provide as an array of strings. Only used when mode is 'execute'.
enable_pretty_outputbooleanOptionalSet to true to format the response with line breaks and indentation for readability. Useful for debugging. Only used when mode is 'execute'.
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'createProjectBrief'.
#

AsanaApi.CreateProjectInWorkspace

Create a new project in a specified workspace. Use this tool to create a new project in a given workspace on Asana. If the workspace is an organization, provide a team to share the project. This action requires the 'projects:write' scope. Returns the full details of the new project. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires path, query parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required path, query parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
workspace_identifierstringOptionalGlobally unique identifier for the workspace or organization where the project will be created. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
include_optional_propertiesarray<string>OptionalComma-separated list of optional properties to include in the response. Only used when mode is 'execute'.
pretty_outputbooleanOptionalSet to true for formatted, readable output. Use mainly during debugging as it increases response time and size. Only used when mode is 'execute'.
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'createProjectForWorkspace'.
#

AsanaApi.CreateProjectStatusUpdate

Creates a new status update for a project. This tool creates a new status update on a specified project in Asana and returns the full record of the newly created project status update. Note: Prefer using the `/status_updates` route for new integrations. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires path, query parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required path, query parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
project_global_idstringOptionalGlobally unique identifier for the project in Asana. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
included_optional_propertiesarray<string>OptionalComma-separated list of optional properties to include in the response, which are excluded by default. Only used when mode is 'execute'.
enable_pretty_outputbooleanOptionalIf true, format the response for readability with line breaks and indentation. Mainly for debugging purposes. Only used when mode is 'execute'.
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'createProjectStatusForProject'.
#

AsanaApi.CreateProjectTemplate

Create a project template in Asana asynchronously. This tool triggers the creation of a project template in Asana and returns details of the asynchronous job handling the process. Use this to save an existing project as a template, enabling its reuse.

Parameters

ParameterTypeReq.Description
project_global_idstringRequiredGlobally unique identifier for the project. Required to specify which project is being saved as a template.
enable_pretty_outputbooleanOptionalEnable pretty output formatting for easier readability in the response. Use mainly for debugging as it may increase response time and size.
include_optional_propertiesarray<string>OptionalSpecify a list of optional properties to include in the response by listing their names as strings.
make_template_publicbooleanOptionalSpecify true to make the project template public to its team. Use false to keep it private.
team_id_for_project_templatestringOptionalSpecify the team ID for the new project template. Use this when the project is in an organization.
template_namestringOptionalThe name of the new project template in Asana.
workspace_id_for_project_templatestringOptionalGlobally unique identifier for the workspace of the new project template. Use only if the project is in a workspace.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'projectSaveAsTemplate'.
#

AsanaApi.CreateSectionInProject

Create a new section in an Asana project. Use this tool to create a new section within a specified Asana project. It returns the complete details of the newly added section, helping you organize tasks by sections.

Parameters

ParameterTypeReq.Description
project_global_idstringRequiredGlobally unique identifier for the project in which to create the section.
enable_pretty_outputbooleanOptionalSet to true for a readable response format with line breaks and indentation. Use for debugging only.
include_optional_propertiesarray<string>OptionalComma-separated list of optional properties to include in the response.
insert_after_section_idstringOptionalID of an existing section to insert the new section after. Cannot be used with insert_before_section_id.
insert_before_section_idstringOptionalID of an existing section in the project before which the new section will be inserted. Cannot be used with 'insert_after_section_id'.
section_namestringOptionalThe name to display as the section title in the project. This cannot be empty.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'createSectionForProject'.
#

AsanaApi.CreateStatusUpdate

Create a new status update on an object in Asana. Use this tool to add a status update to an object in Asana, such as a project. It returns the full record of the newly created status update, providing insight into the update's details and context. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires query parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required query parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
results_per_pageintegerOptionalNumber of status updates to return per page, between 1 and 100. Only used when mode is 'execute'.
pagination_offset_tokenstringOptionalToken to fetch the next page of results. Received from a previous API response for pagination. If omitted, the first page is returned. Only used when mode is 'execute'.
include_optional_fieldsarray<string>OptionalList of properties to include. Provide as an array of strings to include optional properties in the response. Only used when mode is 'execute'.
enable_pretty_outputbooleanOptionalSet to true to receive the response in a readable, indented format. Use for debugging as it increases response time and size. Only used when mode is 'execute'.
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'createStatusForObject'.
#

AsanaApi.CreateSubtaskForTask

Create a new subtask under a specified parent task. This tool is used to create a new subtask and associate it with an existing parent task in Asana. It requires the 'tasks:write' scope and returns the complete record of the newly created subtask. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires path, query parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required path, query parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
parent_task_idstringOptionalThe ID of the parent task for which the new subtask will be created. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
included_optional_fieldsarray<string>OptionalComma-separated list of properties to include in the response. Allows access to optional fields not included by default. Only used when mode is 'execute'.
enable_pretty_outputbooleanOptionalSet to true for a formatted JSON response with line breaks and indentation. Increases size and time; use for debugging. Only used when mode is 'execute'.
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'createSubtaskForTask'.
#

AsanaApi.CreateTimeTrackingEntry

Create a time tracking entry on a task. Use this tool to log time against a specific task in Asana. It returns the information of the newly created time tracking entry, helping to keep task hours updated.

Parameters

ParameterTypeReq.Description
task_idstringRequiredThe unique identifier for the task to operate on.
duration_minutes_trackedintegerOptionalTime in minutes tracked by the entry. Must be greater than 0.
enable_pretty_outputbooleanOptionalSet to true to receive formatted, human-readable JSON responses. Useful for debugging as it may slow down the response.
entry_logged_datestringOptionalOptional. The date the time entry is logged. Defaults to today if not specified.
include_optional_propertiesarray<string>OptionalA list of optional property names to include in the response. This should be used to specify which additional fields you want to include in the return data format when creating a time tracking entry.
project_gid_attributionstringOptionalOptional. The GID of the project to which the tracked time is attributed. If not provided, no project attribution is made.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'createTimeTrackingEntry'.
#

AsanaApi.CreateWorkspaceTag

Create a new tag in a specific Asana workspace. This tool creates a new tag in a designated workspace or organization in Asana. The tag is permanently associated with the specified workspace. It returns the full details of the newly created tag. This is useful for organizing tasks with a new categorization. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires path, query parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required path, query parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
workspace_idstringOptionalGlobally unique identifier for the workspace or organization in Asana. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
included_optional_propertiesarray<string>OptionalList of optional properties to include in the response, specified as an array of strings. Only used when mode is 'execute'.
enable_pretty_outputbooleanOptionalEnable pretty JSON formatting for improved readability. Use mainly during debugging as it may increase response size. Only used when mode is 'execute'.
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'createTagForWorkspace'.
#

AsanaApi.DeleteAllocation

Deletes a specific allocation in Asana. Use this tool to delete an existing allocation in Asana by providing the allocation ID. Useful for tasks where removing resource allocations is needed.

Parameters

ParameterTypeReq.Description
allocation_idstringRequiredGlobally unique identifier for the allocation to be deleted.
pretty_formattingbooleanOptionalProvide pretty JSON formatting for better readability, recommended for debugging.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'deleteAllocation'.
#

AsanaApi.DeleteAsanaGoal

Delete a specific goal in Asana. Use this tool to delete an existing goal in Asana by specifying the goal ID.

Parameters

ParameterTypeReq.Description
goal_identifierstringRequiredThe unique global identifier for the specific Asana goal to delete.
enable_pretty_outputbooleanOptionalIf true, provides pretty JSON output with indentation and line breaks for readability. Recommended for debugging due to increased response size and time.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'deleteGoal'.
#

AsanaApi.DeleteAsanaMembership

Delete a membership in Asana. Delete a specific, existing membership for a goal, project, portfolio, or custom field in Asana by providing the membership ID.

Parameters

ParameterTypeReq.Description
membership_idstringRequiredGlobally unique identifier for the membership to be deleted.
pretty_output_enabledbooleanOptionalEnable pretty-printed JSON format for a more readable response. Recommended for debugging, as it increases response time and size.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'deleteMembership'.
#

AsanaApi.DeleteAsanaProject

Delete a specific project in Asana. Use this tool to delete an existing project in Asana by providing the project's unique identifier. The tool is called when you need to remove a project from Asana, and it confirms the deletion without returning any additional data.

Parameters

ParameterTypeReq.Description
project_unique_identifierstringRequiredGlobally unique identifier for the project to be deleted in Asana.
enable_pretty_outputbooleanOptionalEnable pretty formatting for the response to make it more readable. It's recommended for debugging purposes only due to increased response size and time.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'deleteProject'.
#

AsanaApi.DeleteAsanaSection

Delete a specific, existing section in Asana. This tool deletes a specific, existing section in an Asana project using its GID. Note that the section must be empty to be deleted, and the last remaining section cannot be removed. The tool confirms deletion or provides error details if it fails.

Parameters

ParameterTypeReq.Description
section_global_identifierstringRequiredThe globally unique identifier for the section to be deleted in Asana.
enable_pretty_outputbooleanOptionalIf true, returns JSON with line breaks and indentation for readability. Increases response time and size, suitable for debugging.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'deleteSection'.
#

AsanaApi.DeleteAsanaStory

Delete a story you've created on Asana. This tool deletes a story on Asana if the story was created by the user. It should be called when a user wants to remove their own stories for tasks or projects in Asana.

Parameters

ParameterTypeReq.Description
story_unique_idstringRequiredGlobally unique identifier for the story to be deleted.
enable_pretty_outputbooleanOptionalEnable this for a readable, formatted response. Useful for debugging, but increases response time.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'deleteStory'.
#

AsanaApi.DeleteAsanaTag

Delete a specific tag in Asana with its unique ID. Use this tool to delete an existing tag in Asana by providing its unique global ID (tag_gid). This operation is permanent and should be used when a tag is no longer needed.

Parameters

ParameterTypeReq.Description
tag_unique_identifierstringRequiredThe globally unique identifier for the Asana tag to be deleted.
enable_pretty_outputbooleanOptionalSet to true for formatted JSON output with line breaks and indentation. Use mainly for debugging as it increases response size.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'deleteTag'.
#

AsanaApi.DeleteAsanaTask

Delete an existing task in Asana, moving it to trash. Use this tool to delete a specific task in Asana. The task will be moved to the user's trash, where it can be recovered within 30 days. This tool is useful for managing tasks that are no longer needed or were created by mistake.

Parameters

ParameterTypeReq.Description
task_identifierstringRequiredThe unique identifier of the task to delete in Asana.
pretty_output_enabledbooleanOptionalSet to true for 'pretty' formatted response, useful for debugging. May increase response size and time.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'deleteTask'.
#

AsanaApi.DeleteAsanaWebhook

Permanently delete a webhook in Asana. Use this tool to permanently remove a webhook from Asana. Even after deletion, requests that were in flight may still be received. No further requests will be issued once the webhook is deleted. Ensure you have the required 'webhooks:delete' scope.

Parameters

ParameterTypeReq.Description
webhook_global_idstringRequiredGlobally unique identifier for the specific webhook to delete in Asana.
enable_pretty_outputbooleanOptionalIf true, formats the response with line breaks and indentation for readability. Use primarily for debugging as it increases response time and size.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'deleteWebhook'.
#

AsanaApi.DeleteAttachment

Delete a specific attachment in Asana. Use this tool to delete an existing attachment in Asana by providing the attachment's unique ID. Requires `attachments:delete` scope.

Parameters

ParameterTypeReq.Description
attachment_unique_idstringRequiredGlobally unique identifier for the attachment to be deleted.
pretty_output_enabledbooleanOptionalSet to true to return the response in a readable format with line breaks and indentation. Use for debugging, as it increases response time and size.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'deleteAttachment'.
#

AsanaApi.DeleteCustomField

Delete a specific custom field in Asana. Use this tool to delete a specific custom field in Asana. Locked custom fields can only be deleted by the user who locked them. It returns confirmation of the deletion.

Parameters

ParameterTypeReq.Description
custom_field_idstringRequiredThe unique global identifier for the custom field to be deleted.
pretty_outputbooleanOptionalSet to true for a formatted and indented response; mainly for debugging.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'deleteCustomField'.
#

AsanaApi.DeletePortfolio

Delete an existing portfolio in Asana. Use this tool to delete an existing portfolio by specifying the portfolio's ID in Asana. It should be called when a user needs to remove a portfolio from their system.

Parameters

ParameterTypeReq.Description
portfolio_global_idstringRequiredGlobally unique identifier for the portfolio to be deleted.
enable_pretty_outputbooleanOptionalEnable this to receive a 'pretty' formatted JSON response, advisable for debugging only as it increases response time and size.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'deletePortfolio'.
#

AsanaApi.DeleteProjectBrief

Delete a specific project brief in Asana. Use this tool to delete an existing project brief in Asana by providing its unique identifier. The operation returns confirmation of deletion.

Parameters

ParameterTypeReq.Description
project_brief_unique_idstringRequiredGlobally unique identifier for the project brief to be deleted.
enable_pretty_outputbooleanOptionalSet to true for pretty-formatted output, making it more readable. Useful for debugging, this may increase response time and size.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'deleteProjectBrief'.
#

AsanaApi.DeleteProjectStatus

Delete a specific project status update in Asana. This tool deletes an existing project status update in Asana. It should be called when you need to remove a specific status update from a project. Note: This endpoint is deprecated; consider using the `/status_updates/{status_gid}` route for new integrations.

Parameters

ParameterTypeReq.Description
project_status_idstringRequiredThe identifier for the project status update you wish to delete.
pretty_outputbooleanOptionalEnable pretty output for readable formatting during debugging; increases response size and time.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'deleteProjectStatus'.
#

AsanaApi.DeleteProjectTemplate

Delete a specific existing project template in Asana. Use this tool to permanently delete a specific project template in Asana by providing the template's unique identifier.

Parameters

ParameterTypeReq.Description
project_template_identifierstringRequiredGlobally unique identifier for the Asana project template to delete.
enable_pretty_outputbooleanOptionalIf true, outputs the response in a readable, pretty format with line breaks and indentation, mainly for debugging purposes.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'deleteProjectTemplate'.
#

AsanaApi.DeleteStatusUpdate

Delete a specific status update from Asana. Use this tool to remove a specific status update in Asana by providing the status update's unique ID. This is useful for managing project updates and maintaining current information. The tool confirms successful deletion.

Parameters

ParameterTypeReq.Description
status_update_idstringRequiredUnique ID of the status update to be deleted.
pretty_outputbooleanOptionalIf true, the response is formatted for readability with line breaks and indentation. This increases response size and time, so use for debugging.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'deleteStatus'.
#

AsanaApi.DeleteTaskTemplate

Delete a specific task template by its ID. Use this tool to delete an existing task template in Asana by providing its unique GID. It's useful for removing templates that are no longer needed.

Parameters

ParameterTypeReq.Description
task_template_idstringRequiredGlobally unique identifier for the task template to be deleted.
enable_pretty_outputbooleanOptionalSet to True for a pretty, formatted JSON response. This is useful for debugging but may increase response time and size.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'deleteTaskTemplate'.
#

AsanaApi.DeleteTimeTrackingEntry

Delete a specific time tracking entry in Asana. Use this tool to delete an existing time tracking entry by specifying its unique identifier in Asana. Useful for managing and correcting time tracking data.

Parameters

ParameterTypeReq.Description
time_tracking_entry_identifierstringRequiredGlobally unique identifier for the time tracking entry to be deleted.
enable_pretty_outputbooleanOptionalSet to true for a formatted, readable JSON response. Use for debugging; increases response time and size.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'deleteTimeTrackingEntry'.
#

AsanaApi.DuplicateAsanaTask

Create a job to duplicate a task in Asana. This tool creates and returns a job that will asynchronously handle the duplication of a specified task in Asana. It should be called when there's a need to copy an existing task.

Parameters

ParameterTypeReq.Description
task_gidstringRequiredThe unique identifier of the task to duplicate in Asana.
enable_pretty_outputbooleanOptionalEnable pretty printing of the JSON response for improved readability. Use this primarily for debugging as it increases response size and time.
fields_to_duplicatestringOptionalComma-separated list of task fields to duplicate, such as assignee, attachments, dates, etc.
new_task_namestringOptionalThe name for the newly duplicated task in Asana.
optional_fields_to_includearray<string>OptionalComma-separated list of optional properties to include in the response.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'duplicateTask'.
#

AsanaApi.FetchAsanaEvents

Fetches detailed records of recent Asana events. This tool retrieves a complete record of all events in Asana that occurred since a specific sync token was created. It should be called when you need to obtain the latest activities or changes related to a resource. If more than 100 events exist, the response will indicate additional events are available.

Parameters

ParameterTypeReq.Description
target_resource_idstringRequiredThe ID of the resource to subscribe to. It can be a task, project, or goal.
enable_pretty_outputbooleanOptionalEnable pretty JSON output with line breaks and indentation for readability; primarily for debugging.
include_optional_propertiesarray<string>OptionalComma-separated list of property names to include in the response for more detailed event records.
sync_tokenstringOptionalA sync token from the last request, or omit on the first sync to receive events from the start point. Ensure to handle the token for continued syncing.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'getEvents'.
#

AsanaApi.FetchAttachmentDetails

Fetch the full record of a specific attachment. Retrieves detailed information for a single attachment in Asana. Use this tool to access complete attachment records by attachment ID.

Parameters

ParameterTypeReq.Description
attachment_unique_idstringRequiredThe globally unique identifier for the attachment in Asana.
enable_pretty_outputbooleanOptionalSet to true for pretty-printed JSON output. Increases response size and time; recommended for debugging.
include_optional_propertiesarray<string>OptionalAn array of properties to include in the response. Specify which additional fields you want in the returned attachment record.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'getAttachment'.
#

AsanaApi.FetchJobDetails

Fetch complete details for a specific job record in Asana. Use this tool to obtain the full record of a job by providing the job ID. Ideal for retrieving detailed information about specific jobs in Asana.

Parameters

ParameterTypeReq.Description
job_idstringRequiredGlobally unique identifier for the job to fetch details for.
include_optional_propertiesarray<string>OptionalComma-separated list of optional properties to include in the response for the job.
opt_prettybooleanOptionalSet to true for pretty output with line breaks and indentation. Use this for debugging as it increases response time and size.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'getJob'.
#

AsanaApi.FetchProjectTaskTemplates

Retrieve compact task template records for a specific project. Call this tool to obtain a list of compact task template records from Asana for a given project. This can be useful when you need to view or manage task templates associated with a particular project scope.

Parameters

ParameterTypeReq.Description
enable_pretty_outputbooleanOptionalEnable this to receive the response in a readable format with proper indentation. Useful for debugging, but increases response time and size.
optional_fields_to_includearray<string>OptionalA list of property names to include in the response. Specify the properties you wish to see for the task templates.
pagination_offset_tokenstringOptionalOffset token for pagination, returned by the API. Use to request the next page of results.
project_idstringOptionalThe unique identifier for the project to filter task templates.
results_per_pageintegerOptionalNumber of task templates to return per page, between 1 and 100.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'getTaskTemplates'.
#

AsanaApi.FetchReactionsByEmoji

Retrieve reactions with a specific emoji on an object. Use this tool to get a list of reactions for a specific emoji character on an Asana object. Useful for analyzing engagement or feedback expressed through emojis.

Parameters

ParameterTypeReq.Description
emoji_base_characterstringRequiredSpecify the emoji base character to filter reactions. Returns only reactions with this emoji.
object_gidstringRequiredGlobally unique identifier (GID) for the Asana object (status update or story) from which to fetch reactions.
enable_pretty_outputbooleanOptionalEnable for readable JSON output with line breaks and indentation. Use primarily for debugging due to increased response size and time.
pagination_offset_tokenstringOptionalOffset token to retrieve the next page of results. Use the token provided by a previous paginated request. If not specified, the API returns the first page.
results_per_pageintegerOptionalSpecify the number of results to return per page. Must be between 1 and 100.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'getReactionsOnObject'.
#

AsanaApi.FetchStatusUpdate

Fetch the complete record for a specific status update. Use this tool to get detailed information about a specific status update by providing its unique identifier.

Parameters

ParameterTypeReq.Description
status_update_idstringRequiredUnique identifier for the status update to retrieve the complete record.
enable_pretty_outputbooleanOptionalSet to true for a readable, pretty format with indentation. Useful for debugging.
include_optional_fieldsarray<string>OptionalA list of optional fields to include in the response. Provide the fields as a list of strings.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'getStatus'.
#

AsanaApi.FetchTaskTemplate

Retrieve the complete record of a specific task template in Asana. Use this tool to get detailed information about a task template from Asana by providing the task template's GID. Make sure your token has the 'task_templates:read' scope.

Parameters

ParameterTypeReq.Description
task_template_unique_idstringRequiredGlobally unique identifier for the task template to retrieve its complete record.
enable_pretty_outputbooleanOptionalEnable pretty formatting for the output, making it more readable with line breaking and indentation. Use mainly for debugging.
include_optional_fieldsarray<string>OptionalSpecify properties to include in the response. Provide as a list of strings.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'getTaskTemplate'.
#

AsanaApi.FetchTeamMembers

Retrieve the team memberships for a given team in Asana. Use this tool to obtain a list of team memberships for a specific team in Asana, providing insight into who is part of the team.

Parameters

ParameterTypeReq.Description
team_global_identifierstringRequiredGlobally unique identifier for the team to retrieve memberships for.
enable_pretty_outputbooleanOptionalBoolean to enable pretty formatted output with line breaks and indentation. Recommended for debugging due to increased response size and time.
optional_properties_to_includearray<string>OptionalA list of optional properties to include in the results, given as an array of strings. Each string should be a property you wish to include.
pagination_offset_tokenstringOptionalToken to retrieve the next page of results. Use the offset provided in a previous response for pagination.
results_per_pageintegerOptionalNumber of objects to return per page. Must be between 1 and 100.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'getTeamMembershipsForTeam'.
#

AsanaApi.FetchTimeTrackingData

Fetch time tracking entries from Asana. Retrieve a list of time tracking entries filtered by specific tasks, attributed projects, portfolios, or users in Asana. Requires the 'time_tracking_entries:read' scope.

Parameters

ParameterTypeReq.Description
enable_pretty_outputbooleanOptionalEnable pretty formatting for the response. Useful for debugging, but increases response time and size.
include_optional_fieldsarray<string>OptionalInclude optional properties in the response by listing field names as a comma-separated array. This enhances the response data detail.
pagination_offset_tokenstringOptionalToken to specify the starting point for retrieving the next page of results. Use the offset returned from a previous request. If not provided, the first page is returned.
portfolio_idstringOptionalGlobally unique identifier for the portfolio to filter time tracking entries by.
project_identifier_attributionstringOptionalUnique ID for the project to filter time tracking entries by attribution.
results_per_pageintegerOptionalSpecify the number of time tracking entries to return per page. Acceptable values are between 1 and 100.
task_idstringOptionalGlobally unique identifier for the task to filter time tracking entries by. This is used to specify the task whose time tracking entries you want to retrieve.
user_id_filterstringOptionalGlobally unique identifier for the user to filter time tracking entries by.
workspace_identifierstringOptionalGlobally unique identifier for the Asana workspace to filter the time tracking entries.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'getTimeTrackingEntries'.
#

AsanaApi.FetchUserTaskDetails

Retrieve the full record for a user task list. Call this tool to obtain detailed information about a specific user's task list in Asana. This requires read permissions on tasks.

Parameters

ParameterTypeReq.Description
user_task_list_global_idstringRequiredGlobally unique identifier for the user task list in Asana.
enable_pretty_outputbooleanOptionalSet to true for readable, indented JSON output. Use primarily for debugging due to increased response size.
include_optional_propertiesarray<string>OptionalSpecify which optional properties should be included in the response. Provide as a list of strings.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'getUserTaskList'.
#

AsanaApi.FetchUserTasks

Fetch the full task list record for a user from Asana. This tool retrieves the complete task list for a specified user in Asana, requiring the 'tasks:read' permission.

Parameters

ParameterTypeReq.Description
user_identifierstringRequiredA string to identify the user, either "me", an email, or the user's gid.
workspace_idstringRequiredThe ID of the workspace to retrieve the user's task list from in Asana.
enable_pretty_outputbooleanOptionalEnable pretty formatting for JSON responses. When true, the response includes line breaks and indentation for better readability. This increases response size and processing time, so use primarily for debugging.
include_optional_propertiesarray<string>OptionalA list of optional properties to include in the response, specified as an array of strings.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'getUserTaskListForUser'.
#

AsanaApi.GetAllocationRecord

Fetch the complete allocation record for a given ID. This tool provides detailed information about an allocation using its unique ID. It should be called when you need to access specific allocation data from Asana.

Parameters

ParameterTypeReq.Description
allocation_unique_idstringRequiredGlobally unique identifier for the allocation to fetch the complete record.
enable_pretty_outputbooleanOptionalSet to true to receive the response in a pretty, readable format. Useful for debugging, but increases response size and time.
include_optional_propertiesarray<string>OptionalComma-separated list of optional properties to include in the response, as some properties are excluded by default.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'getAllocation'.
#

AsanaApi.GetAsanaGoalDetails

Fetches detailed information for a specific Asana goal. This tool retrieves the complete record of a specified goal in Asana, including associated time periods and custom field settings. It requires the necessary permissions: 'goals:read', 'time_periods:read', and 'custom_fields:read'.

Parameters

ParameterTypeReq.Description
goal_global_identifierstringRequiredGlobally unique identifier for the goal to be retrieved.
enable_pretty_outputbooleanOptionalIf true, formats the response with line breaks and indentation for readability, increasing response size and time.
include_optional_fieldsarray<string>OptionalSpecify optional properties to include in the response as a list of strings.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'getGoal'.
#

AsanaApi.GetAsanaProjects

Fetch filtered project records from Asana. Retrieve compact project records from Asana by applying optional filters for more efficient data handling, especially in large domains. Ensure the 'projects:read' scope is authorized.

Parameters

ParameterTypeReq.Description
enable_pretty_outputbooleanOptionalEnable pretty JSON formatting for debugging. Increases response size and processing time.
optional_fields_to_includearray<string>OptionalComma-separated list of optional properties to include in the response.
pagination_offset_tokenstringOptionalThe offset token for pagination to obtain the next page of results. Use this token received from a previous request to continue retrieving subsequent data.
results_per_pageintegerOptionalNumber of projects to return per page, from 1 to 100.
return_only_archived_projectsbooleanOptionalBoolean to filter projects by their archived status. Setting this to true returns only archived projects.
team_filterstringOptionalSpecify the team to filter projects in the Asana workspace.
workspace_filterstringOptionalSpecify the workspace or organization to filter the Asana projects.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'getProjects'.
#

AsanaApi.GetAsanaProjectTemplates

Fetch project template records from Asana. Retrieve compact project template records for all templates in a specified team or workspace within Asana. This requires the 'project_templates:read' scope.

Parameters

ParameterTypeReq.Description
include_optional_fieldsarray<string>OptionalA list of optional properties to include in the response. Provide as an array of strings, with each string representing a property name.
pagination_offset_tokenstringOptionalOffset token for pagination. Use the token returned from a previous request to fetch the next page of results. If omitted, the first page is returned.
pretty_outputbooleanOptionalSet to true to enable pretty JSON formatting for debugging, despite increased size and time.
results_per_pageintegerOptionalSpecify the number of project templates to return per page, between 1 and 100.
team_filterstringOptionalThe team ID to filter project templates on.
workspace_identifierstringOptionalThe identifier of the workspace to filter project templates results on.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'getProjectTemplates'.
#

AsanaApi.GetAsanaSection

Retrieve a complete record of a single Asana section. Use this tool to obtain detailed information about a specific section in Asana by providing the section's GID.

Parameters

ParameterTypeReq.Description
section_global_idstringRequiredThe globally unique identifier for the section to retrieve.
enable_pretty_outputbooleanOptionalSet to true to receive the response in a 'pretty' format with line breaks and indentation. Useful for debugging. This increases response time and size.
include_optional_propertiesarray<string>OptionalSpecify a list of optional properties to include in the response. This should be an array of strings.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'getSection'.
#

AsanaApi.GetAsanaStory

Fetch the full record of a specific Asana story. Use this tool to retrieve detailed information about a specific story in Asana. It requires the 'stories:read' scope, and optionally reads 'attachments:read' for previews and attachments.

Parameters

ParameterTypeReq.Description
story_identifierstringRequiredGlobally unique identifier for the Asana story to be retrieved.
enable_pretty_outputbooleanOptionalSet to true to format the response with line breaks and indentation for readability. Recommended only for debugging, as it increases response size and processing time.
include_optional_propertiesarray<string>OptionalA list of optional properties to include in the story record, specified as an array of strings.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'getStory'.
#

AsanaApi.GetAsanaTagDetails

Retrieve complete details for a specific Asana tag. Fetches the full tag record for a provided tag ID in Asana. Useful for obtaining information about a specific tag to understand its properties and associated tasks.

Parameters

ParameterTypeReq.Description
tag_global_identifierstringRequiredGlobally unique identifier for the tag in Asana used to fetch the complete tag details.
enable_pretty_outputbooleanOptionalEnable to format the response in a readable, pretty format. Increases response size and time; useful for debugging.
include_optional_fieldsarray<string>OptionalComma-separated list of additional tag properties to include in the response.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'getTag'.
#

AsanaApi.GetAsanaTeamDetails

Retrieve detailed information for a specific Asana team. Use this tool to obtain the complete details of a specific team in Asana. It requires the 'teams:read' scope and returns all available data for the team identified by its GID.

Parameters

ParameterTypeReq.Description
team_global_idstringRequiredGlobally unique identifier for the specific Asana team to retrieve details for.
enable_pretty_outputbooleanOptionalSet to true for human-readable formatting, with line breaks and indentation. Increases response time and size; use for debugging.
include_optional_fieldsarray<string>OptionalComma-separated list of optional properties to include in the response.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'getTeam'.
#

AsanaApi.GetAsanaTeamsForUser

Get all teams assigned to a specific Asana user. Use this tool to retrieve a list of all teams that a specific user is part of in Asana. Requires the 'teams:read' permission scope.

Parameters

ParameterTypeReq.Description
filter_by_organizationstringRequiredSpecify the workspace or organization to filter the teams on for the Asana user.
user_identifierstringRequiredA string identifying a user. Accepts 'me', an email, or user's gid.
enable_pretty_outputbooleanOptionalSet to true to format the response with line breaks and indentation. Useful for debugging but can increase response size.
include_optional_fieldsarray<string>OptionalComma-separated list of optional properties to include in the response.
pagination_offset_tokenstringOptionalOffset token to navigate through paginated results. Use an offset from a previous request to get the next page. If not provided, the first page is returned.
results_per_pageintegerOptionalNumber of team records to return per page. Must be between 1 and 100.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'getTeamsForUser'.
#

AsanaApi.GetAsanaTeamsForWorkspace

Retrieve all teams for a specified Asana workspace. Use this tool to get a list of all teams in an Asana workspace visible to the user. Ensure the required scope 'teams:read' is granted.

Parameters

ParameterTypeReq.Description
workspace_global_idstringRequiredGlobally unique identifier for the workspace or organization in Asana.
enable_pretty_outputbooleanOptionalSet to true to receive the response in a 'pretty' JSON format with line breaks and indentation. Useful for debugging but increases response time and size.
include_optional_fieldsarray<string>OptionalComma-separated list of optional properties to include in the response.
pagination_offset_tokenstringOptionalAn offset token for pagination. Use a token from a previous request to retrieve the next page of results. If not provided, the first page is returned.
results_per_pageintegerOptionalNumber of teams to return per page, between 1 and 100.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'getTeamsForWorkspace'.
#

AsanaApi.GetAsanaUsers

Retrieve Asana user records across workspaces. Fetches user records from Asana for all users in workspaces and organizations accessible to the authenticated user. An optional workspace ID can be provided to filter results. The data is sorted by user ID and requires the 'users:read' scope.

Parameters

ParameterTypeReq.Description
enable_pretty_outputbooleanOptionalEnable pretty formatting of the response for easier readability. Recommended for debugging as it increases response size and time.
filter_by_team_idstringOptionalThe team ID to filter users in Asana. It allows you to specify a particular team to narrow down the user results.
include_optional_propertiesarray<string>OptionalComma-separated list of optional user properties to include in the response. Use this to fetch additional fields excluded by default.
pagination_offset_tokenstringOptionalOffset token for pagination, used to fetch subsequent pages of results. Only valid when using an offset returned in a prior request.
results_per_pageintegerOptionalThe number of user records to return per page. Must be between 1 and 100.
workspace_idstringOptionalThe ID of the workspace or organization to filter users on.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'getUsers'.
#

AsanaApi.GetAsanaWebhooks

Retrieve all registered Asana webhooks for a workspace. Use this tool to get a compact representation of all webhooks registered by your app for the authenticated user in a specified Asana workspace. Requires the 'webhooks:read' scope.

Parameters

ParameterTypeReq.Description
workspace_idstringRequiredThe unique identifier of the Asana workspace to query for webhooks.
enable_pretty_outputbooleanOptionalSet to true for a readable, pretty-formatted JSON output. Increases response time and size. Use mainly for debugging.
include_optional_propertiesarray<string>OptionalComma-separated list of properties to include in the response, which are excluded by default.
pagination_offset_tokenstringOptionalAn offset token to retrieve the next page of results. Use the token from a previous API response for pagination.
results_per_pageintegerOptionalNumber of webhooks to return per page, between 1 and 100.
specific_resourcestringOptionalSpecify the resource ID to filter webhooks for that particular resource.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'getWebhooks'.
#

AsanaApi.GetAttachments

Retrieve all attachments for a specified Asana object. This tool returns all attachments associated with a specified Asana object. It can be used to get attachments for projects, project briefs, and tasks. For projects, it provides files from the "Key resources" section; for project briefs, inline files in the brief itself; for tasks, all associated files, including inline images in descriptions.

Parameters

ParameterTypeReq.Description
object_gidstringRequiredGlobally unique identifier for the Asana object to fetch attachments from, such as a `project`, `project_brief`, or `task`.
enable_pretty_outputbooleanOptionalReturn the response in a readable format with line breaks and indentation. Recommended for debugging as it may increase response size and time.
include_optional_propertiesarray<string>OptionalComma-separated list of properties to include, which are excluded by default.
pagination_offset_tokenstringOptionalToken for pagination. Use this to get the next page of results. If omitted, the first page is returned. Use only tokens from previous responses.
results_per_pageintegerOptionalNumber of objects to return per page, must be between 1 and 100.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'getAttachmentsForObject'.
#

AsanaApi.GetCompactGoals

Retrieve compact goal records from Asana. Use this tool to get a summary of goals available in Asana. It should be called when you need to access an overview of goals, requiring the 'goals:read' permission scope.

Parameters

ParameterTypeReq.Description
enable_pretty_outputbooleanOptionalEnable pretty formatting for readable JSON response. Mainly for debugging; increases response time and size.
included_optional_propertiesarray<string>OptionalA list of specific properties to include in the response. Use a comma-separated list format.
is_workspace_levelbooleanOptionalSet to true to filter for goals where the workspace level is active. Must be used with the workspace parameter.
pagination_offset_tokenstringOptionalOffset token for pagination. Use the token from a previous response to retrieve the next page. If not provided, returns the first page.
portfolio_idstringOptionalGlobally unique identifier for the supporting portfolio in Asana.
project_idstringOptionalGlobally unique identifier for the project. Used to filter goals associated with a specific project.
results_per_pageintegerOptionalThe number of goal records to return per page. Must be between 1 and 100.
supporting_task_idstringOptionalGlobally unique identifier for the supporting task in Asana.
team_idstringOptionalGlobally unique identifier for the team. Use this to filter goals associated with a specific team.
time_period_identifiersarray<string>OptionalA list of globally unique identifiers for the desired time periods to filter the goals.
workspace_idstringOptionalGlobally unique identifier for the workspace.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'getGoals'.
#

AsanaApi.GetCustomFieldMetadata

Retrieve complete metadata of a custom field in Asana. Fetches the full definition of a custom field's metadata in Asana, including type-specific details such as enum options.

Parameters

ParameterTypeReq.Description
custom_field_idstringRequiredGlobally unique identifier for the custom field in Asana to retrieve its metadata.
enable_pretty_outputbooleanOptionalEnable pretty printing for the output, making it more readable. Ideal for debugging, but increases response time and size.
include_optional_propertiesarray<string>OptionalComma-separated list of optional properties to include in the response.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'getCustomField'.
#

AsanaApi.GetCustomFieldSettingsForProject

Get custom field settings for a specified project. Use this tool to retrieve all custom field settings associated with a specific project in Asana. It returns a list in compact form, which can be expanded using `opt_fields` to include additional data.

Parameters

ParameterTypeReq.Description
project_idstringRequiredGlobally unique identifier for the Asana project to retrieve custom field settings.
enable_pretty_outputbooleanOptionalEnable to receive a pretty, human-readable response with line breaks and indentation. Increases response time and size, use for debugging.
include_optional_fieldsarray<string>OptionalComma-separated list of property names to include in the response, expanding beyond the default fields.
pagination_offset_tokenstringOptionalAn offset token for pagination. Use the token from a previous request to get the next page of results. If not provided, it returns the first page.
results_per_pageintegerOptionalSpecify the number of custom field settings to return per page, between 1 and 100.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'getCustomFieldSettingsForProject'.
#

AsanaApi.GetCustomFieldsForWorkspace

Retrieve custom fields for a specific workspace. Fetches a list of all custom fields in a specified workspace, using Asana's API. Requires the 'custom_fields:read' scope.

Parameters

ParameterTypeReq.Description
workspace_identifierstringRequiredGlobally unique identifier for the workspace or organization in Asana.
enable_pretty_outputbooleanOptionalEnable pretty printed output for the response, useful for debugging. This increases response time and size.
include_optional_propertiesarray<string>OptionalA list of properties to include in the response for a workspace's custom fields. Include values such as 'name', 'type', etc.
pagination_offset_tokenstringOptionalAn offset token for pagination. Use a token from a previous request to continue where it left off. If not used, retrieves the first page.
results_per_pageintegerOptionalSpecifies the number of custom fields to return per page, between 1 and 100.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'getCustomFieldsForWorkspace'.
#

AsanaApi.GetCustomTypeDetails

Retrieve complete details of a specific custom type in Asana. Use this to obtain the full record for a custom type by its ID. Useful for accessing detailed information about custom types within Asana projects.

Parameters

ParameterTypeReq.Description
custom_type_idstringRequiredGlobally unique identifier for the custom type in Asana.
enable_pretty_outputbooleanOptionalIf true, the response is formatted with line breaks and indentation for readability. Use this for debugging; it may increase response time and size.
include_optional_fieldsarray<string>OptionalA list of property names to include in the response for the custom type. These are optional fields that are not included by default.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'getCustomType'.
#

AsanaApi.GetCustomTypes

Retrieve all custom types for a project in Asana. Use this tool to get a list of custom types linked to a project in Asana. Customize returned data using `opt_fields` for more detailed information.

Parameters

ParameterTypeReq.Description
project_idstringRequiredGlobally unique identifier for the project to filter custom types.
enable_pretty_outputbooleanOptionalSet to true for pretty-printed JSON output during debugging. Increases response size and time.
include_optional_propertiesarray<string>OptionalComma-separated list of properties to include in the response for additional details.
next_page_offset_tokenstringOptionalOffset token from a previous response to fetch the next page of results. If not provided, the first page will be returned.
results_per_pageintegerOptionalNumber of custom types to return per page. Must be between 1 and 100.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'getCustomTypes'.
#

AsanaApi.GetFilteredTags

Retrieve compact tag records with optional filters. Call this tool to get a list of compact tag records from Asana based on specific filter parameters. Requires 'tags:read' scope.

Parameters

ParameterTypeReq.Description
enable_pretty_outputbooleanOptionalSet to 'true' for pretty JSON output with line breaks and indentation. Use for readability during debugging.
include_optional_propertiesarray<string>OptionalA list of properties to include in the response, specified as strings. Use to retrieve fields not returned by default.
pagination_offsetstringOptionalOffset token for pagination. Use the offset from the previous response to get the next page. If not provided, returns the first page.
results_per_pageintegerOptionalSpecifies how many tag records to return per page. Must be an integer between 1 and 100.
workspace_for_filteringstringOptionalThe workspace ID used to filter tags in the request.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'getTags'.
#

AsanaApi.GetFilteredTasks

Retrieve filtered task records from Asana. Use this tool to get compact task records based on specific filters like project, tag, assignee, or workspace. Ensure to specify a `project` or `tag` if `assignee` and `workspace` are not provided.

Parameters

ParameterTypeReq.Description
assignee_idstringOptionalThe ID of the assignee to filter tasks on. If searching for unassigned tasks, use 'null'. Must be used with 'workspace'.
completed_since_date_timestringOptionalTasks must be incomplete or completed since this date/time. Provide in ISO 8601 format (e.g., '2023-10-01T12:00:00Z').
enable_pretty_outputbooleanOptionalIf true, provides the response in a pretty-printed, readable format. Use primarily for debugging as it increases response time and size.
filter_by_projectstringOptionalSpecify the project to filter tasks. Use a string identifier for the project.
filter_by_workspacestringOptionalThe workspace to filter tasks by. Must be used with 'filter_by_assignee'.
modified_since_timestringOptionalReturn tasks modified since this time. Include changes in properties or associations. Format as string (e.g., 'YYYY-MM-DDTHH:MM:SSZ').
optional_fields_to_includearray<string>OptionalSpecify properties to include in the response by providing an array of property names. These properties are excluded by default.
pagination_offsetstringOptionalAn offset token for pagination to retrieve the next page of results. Use a previously returned token to continue pagination.
results_per_pageintegerOptionalDefines the number of task records to return per page. The value must be between 1 and 100.
section_filterstringOptionalThe section to filter tasks within a project in Asana. Specify a section name to narrow down the tasks.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'getTasks'.
#

AsanaApi.GetGoalRelationshipDetails

Retrieve details of a specific Asana goal relationship. Use this tool to get the complete updated record of a specific goal relationship in Asana by providing the goal relationship ID.

Parameters

ParameterTypeReq.Description
goal_relationship_identifierstringRequiredGlobally unique identifier for the goal relationship you want to retrieve.
enable_pretty_outputbooleanOptionalEnables pretty formatting for the response, increasing readability but also response size and time. Use for debugging.
include_optional_propertiesarray<string>OptionalA comma-separated list of optional properties to include in the response. Use this to include properties that are not returned by default.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'getGoalRelationship'.
#

AsanaApi.GetGoalRelationships

Retrieve compact goal relationship records from Asana. Call this tool to get information on goal relationships within an Asana workspace. It provides a compact view of the connections between goals, which may be useful for tracking progress or understanding hierarchy.

Parameters

ParameterTypeReq.Description
supported_goal_idstringRequiredGlobally unique identifier for the supported goal in the goal relationship.
enable_pretty_outputbooleanOptionalSet to true for pretty JSON output with indentation. Use mainly for debugging as it increases response size and time.
goal_relationship_resource_subtypestringOptionalFilter goal relationships by a specific resource subtype.
include_optional_propertiesarray<string>OptionalComma-separated list of optional properties to include in the response. Allows access to additional fields excluded by default.
pagination_offsetstringOptionalToken to specify the starting point for the next page of results. Use the token from the previous response to continue pagination.
results_per_pageintegerOptionalSpecify the number of goal relationship records to return per page. Must be between 1 and 100.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'getGoalRelationships'.
#

AsanaApi.GetMembershipInfo

Retrieve membership record details by ID. Fetches information for a specified membership ID, including project, goal, portfolio, or custom field memberships.

Parameters

ParameterTypeReq.Description
membership_idstringRequiredGlobally unique identifier for the membership. Used to specify which membership record to retrieve.
enable_pretty_outputbooleanOptionalEnable pretty output with indentation and line breaks for readability. Use for debugging as it increases response size and time.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'getMembership'.
#

AsanaApi.GetMemberships

Retrieve compact membership records from Asana. This tool fetches compact membership records such as goal, project, portfolio, or custom field memberships from Asana. It can filter results to specific memberships by using a member ID.

Parameters

ParameterTypeReq.Description
enable_pretty_outputbooleanOptionalEnable pretty JSON output with line breaks and indentation for readability. Use for debugging purposes as it may increase response time and size.
include_optional_fieldsarray<string>OptionalComma-separated list of optional fields to include in the response.
member_identifierstringOptionalGlobally unique identifier for a team or user to filter specific memberships.
pagination_offset_tokenstringOptionalToken for pagination. Use the offset from a previous API response to get the next page of results.
parent_idstringOptionalGlobally unique identifier for a goal, project, portfolio, or custom field in Asana.
results_per_pageintegerOptionalSpecifies the number of objects to return per page. Must be between 1 and 100.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'getMemberships'.
#

AsanaApi.GetOrganizationExportDetails

Fetch details of a specific organization export. Use this tool to obtain details about a previously-requested export of an organization's data in Asana. It requires the export ID to retrieve the relevant information.

Parameters

ParameterTypeReq.Description
organization_export_idstringRequiredGlobally unique identifier for the organization export. Required to retrieve the export details.
enable_pretty_outputbooleanOptionalSet to true for a human-readable response with line breaks and indentation. Recommended for debugging due to increased response size.
include_optional_propertiesarray<string>OptionalOptional properties to include in the response, as a list of strings. This specifies which additional fields should be returned with the organization export details.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'getOrganizationExport'.
#

AsanaApi.GetParentGoalsForGoal

Fetches parent goals for a specific Asana goal. Use this tool to obtain a list of parent goals for a specified goal in Asana. It requires the 'goals:read' scope to access the data.

Parameters

ParameterTypeReq.Description
goal_unique_identifierstringRequiredGlobally unique identifier for the Asana goal whose parent goals are to be fetched.
include_optional_propertiesarray<string>OptionalList of optional properties to include in the response. It should be a comma-separated list of strings.
pretty_output_enabledbooleanOptionalSet to true for a readable output format with line breaks and indentation, suitable for debugging. May increase response size and time.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'getParentGoalsForGoal'.
#

AsanaApi.GetPendingAccessRequests

Fetch pending access requests for a target object. Use this tool to retrieve pending access requests for a specific target object in Asana. You can also filter these requests by a specific user if needed.

Parameters

ParameterTypeReq.Description
target_object_idstringRequiredGlobally unique identifier for the target object in Asana.
enable_pretty_outputbooleanOptionalSet to true for readable, indented output. Use primarily for debugging due to increased response size.
filter_by_userstringOptionalUser identifier to filter requests. Accepts 'me', an email, or a user gid.
include_optional_propertiesarray<string>OptionalComma-separated list of optional properties to include in the response.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'getAccessRequests'.
#

AsanaApi.GetPortfolioCustomFieldSettings

Retrieve custom field settings for an Asana portfolio. Call this tool to get all the custom field settings associated with a specific portfolio on Asana in compact form.

Parameters

ParameterTypeReq.Description
portfolio_unique_idstringRequiredGlobally unique identifier for the portfolio in Asana.
include_optional_fieldsarray<string>OptionalList optional properties to include in the response, specified as an array of strings.
pagination_offset_tokenstringOptionalOffset token to fetch the next page of results. Use a token returned from a previous request. If not provided, the first page of results will be returned.
pretty_outputbooleanOptionalSet to true for pretty-formatted JSON output, with line breaks and indentation, mainly for debugging purposes.
results_per_pageintegerOptionalSpecify the number of results to return per page. Must be between 1 and 100.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'getCustomFieldSettingsForPortfolio'.
#

AsanaApi.GetPortfolioDetails

Retrieve complete details of a specific portfolio in Asana. This tool is used to obtain the full record of a particular portfolio in Asana, given its unique ID. It requires the 'portfolios:read' scope and returns comprehensive details including any custom field settings if the 'custom_fields:read' scope is also available.

Parameters

ParameterTypeReq.Description
portfolio_unique_idstringRequiredGlobally unique identifier for the specific portfolio to retrieve details.
enable_pretty_outputbooleanOptionalSet to true for pretty, readable formatting of the output. Useful for debugging, but increases response size and time.
include_optional_propertiesarray<string>OptionalList of properties to include in the response. Specify as a list of strings for fields you wish to include, as the API excludes some by default.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'getPortfolio'.
#

AsanaApi.GetPortfolioItems

Retrieve a list of items in a portfolio. This tool fetches a list of items in compact form within a specified portfolio. It requires the 'portfolios:read' scope to access the portfolio data.

Parameters

ParameterTypeReq.Description
portfolio_unique_idstringRequiredGlobally unique identifier for the portfolio. Required to fetch items for a specific portfolio.
enable_pretty_outputbooleanOptionalIf true, the response will be formatted for readability with line breaks and indentation. Recommended for debugging as this can increase response size and time.
include_optional_propertiesarray<string>OptionalComma-separated list of optional properties to include in the response.
pagination_offset_tokenstringOptionalToken for offsetting to the next page of results. Use a token from previous pagination to retrieve subsequent pages.
results_per_pageintegerOptionalThe number of items to return per page, between 1 and 100.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'getItemsForPortfolio'.
#

AsanaApi.GetPortfolioMembership

Retrieve a single portfolio membership record. Use this tool to obtain the complete portfolio record for a specific portfolio membership by its unique identifier.

Parameters

ParameterTypeReq.Description
portfolio_membership_idstringRequiredThe unique identifier for the portfolio membership to retrieve.
enable_pretty_outputbooleanOptionalIf true, enables pretty JSON output with line breaking and indentation, increasing response size and time. Useful for debugging.
include_optional_propertiesarray<string>OptionalA list of optional properties to include in the response, specified as strings.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'getPortfolioMembership'.
#

AsanaApi.GetPortfolioMemberships

Retrieve portfolio memberships from Asana. Retrieve a list of portfolio memberships based on specified criteria such as portfolio, user, or workspace from Asana. Useful for managing and accessing user roles in project management.

Parameters

ParameterTypeReq.Description
enable_pretty_outputbooleanOptionalEnable pretty output formatting with indentation for readability. Ideal for debugging, it increases response time and size.
include_optional_fieldsarray<string>OptionalA list of optional properties to include in the response. Provide them as an array of strings.
pagination_offset_tokenstringOptionalToken for pagination to retrieve the next page of results. Use the offset provided by a previous response.
portfolio_filterstringOptionalSpecify the portfolio ID to filter the results.
results_per_pageintegerOptionalSpecifies the number of portfolio memberships to return per page, between 1 and 100.
user_identifierstringOptionalA string identifier for a user: "me", an email, or the user's gid.
workspace_filterstringOptionalSpecify the workspace to filter portfolio membership results. This should match the workspace identifier used in Asana.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'getPortfolioMemberships'.
#

AsanaApi.GetProjectAllocations

Retrieve allocations for a specific project, user, or placeholder. Use this tool to get a list of work allocations filtered by a specific project, user, or placeholder in Asana.

Parameters

ParameterTypeReq.Description
assignee_idstringOptionalGlobally unique identifier for the user or placeholder the allocation is assigned to.
enable_pretty_outputbooleanOptionalEnable pretty output format for JSON. Use this for easier reading during debugging, as it increases response size and processing time.
include_optional_propertiesarray<string>OptionalList properties to include in the response, provided as a list of strings. Provides access to additional data fields.
pagination_offsetstringOptionalOffset token for pagination. Use this to retrieve the next page of results. If not provided, the first page will be returned. Only use offsets returned from previous requests.
project_idstringOptionalGlobally unique identifier for the project to filter allocations by.
results_per_pageintegerOptionalThe number of allocations to return per page, between 1 and 100.
workspace_idstringOptionalGlobally unique identifier for the workspace to filter allocations by.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'getAllocations'.
#

AsanaApi.GetProjectBrief

Retrieve the full record for a project brief. Use this tool to obtain the complete details of a specific project brief by its unique identifier. Ideal for accessing comprehensive project information within Asana.

Parameters

ParameterTypeReq.Description
project_brief_identifierstringRequiredGlobally unique identifier for the specific project brief to retrieve.
include_optional_propertiesarray<string>OptionalAn array of property names to include in the response. These properties are excluded by default.
pretty_output_enabledbooleanOptionalEnable readable, formatted output. Suitable for debugging. Increases response time and size.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'getProjectBrief'.
#

AsanaApi.GetProjectDetails

Retrieve complete details of a specified Asana project. This tool retrieves the complete record of a specific project from Asana. It requires 'projects:read' scope and additional scopes for accessing custom field settings and team information, if needed.

Parameters

ParameterTypeReq.Description
project_global_identifierstringRequiredA unique identifier for the Asana project you want to retrieve details for.
enable_pretty_outputbooleanOptionalSet to true for nicely formatted, readable output, mainly for debugging due to increased size and time.
include_optional_propertiesarray<string>OptionalA list of optional property names to include in the project details response. Provide these as a list of strings.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'getProject'.
#

AsanaApi.GetProjectMembershipDetails

Retrieve detailed information for a project membership in Asana. Call this tool to get a detailed record of a specific project membership in Asana by providing the project membership ID.

Parameters

ParameterTypeReq.Description
project_membership_idstringRequiredThe unique identifier for the project membership to retrieve details for.
enable_pretty_outputbooleanOptionalSet to true for a human-readable response format, useful for debugging.
include_optional_propertiesarray<string>OptionalA list of optional project membership properties to include in the response. These are normally excluded by default.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'getProjectMembership'.
#

AsanaApi.GetProjectMemberships

Fetch project membership records from Asana. Retrieve compact information about project memberships for a specified project in Asana.

Parameters

ParameterTypeReq.Description
project_unique_identifierstringRequiredGlobally unique identifier for the project to fetch memberships for.
enable_pretty_outputbooleanOptionalEnable pretty formatting for the response output. Useful for debugging as it adds line breaks and indentation, making it more readable. Note: This increases response size and time.
include_optional_propertiesarray<string>OptionalList of properties to include in the response. Use a comma-separated list to specify optional properties to be included in the response.
page_offset_tokenstringOptionalToken for pagination to retrieve the next set of results. Use the token from a previous response to get subsequent pages.
results_per_pageintegerOptionalThe number of objects to return per page (between 1 and 100).
user_identifierstringOptionalA string identifying a user, either "me", an email, or the user's gid.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'getProjectMembershipsForProject'.
#

AsanaApi.GetProjectSections

Fetch compact records for sections in a specified project. Use this tool to obtain a list of all sections within a specific project on Asana. It helps in managing and organizing project components effectively by retrieving key details of each section.

Parameters

ParameterTypeReq.Description
project_unique_identifierstringRequiredGlobally unique identifier for the project in Asana.
enable_pretty_outputbooleanOptionalEnables readable formatting of the response when true, using line breaks and indentation. Recommended for debugging as it increases response time and size.
included_optional_fieldsarray<string>OptionalList of optional properties to include in the response, specified as strings. This allows you to fetch additional details about the sections that are not included by default.
pagination_offset_tokenstringOptionalOffset token for paginated API requests. Use it to retrieve the next set of results. If not provided, the API returns the first page.
results_per_pageintegerOptionalSpecify the number of sections to return per page, between 1 and 100.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'getSectionsForProject'.
#

AsanaApi.GetProjectsForTask

Retrieve all projects associated with a specific task. Returns a compact list of projects that a specified task is part of. Useful for understanding task context within various projects.

Parameters

ParameterTypeReq.Description
task_identifierstringRequiredThe identifier of the task to retrieve associated projects for.
enable_pretty_outputbooleanOptionalSet to true to receive the output in a 'pretty' format, useful for debugging. Note: This increases response time and size.
optional_fields_to_includearray<string>OptionalComma-separated list of optional project properties to include in the response.
pagination_offsetstringOptionalOffset token used for pagination. If not provided, the first page is returned. Only pass an offset returned from a previous request.
results_per_pageintegerOptionalNumber of project entries to return per page, between 1 and 100.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'getProjectsForTask'.
#

AsanaApi.GetProjectStatusUpdate

Fetches a complete status update record for a project. Retrieves the full details of a specific project status update. Note that this endpoint is deprecated, and new integrations should use `/status_updates/{status_gid}` instead.

Parameters

ParameterTypeReq.Description
project_status_update_idstringRequiredThe ID of the project status update to retrieve. This should be a unique identifier for the specific status update.
enable_pretty_outputbooleanOptionalIf true, formats the response with line breaks and indentation for readability. Recommended for debugging only, as it increases response size.
include_optional_propertiesarray<string>OptionalA list of optional properties to include in the response. This allows fetching additional details that are excluded by default.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'getProjectStatus'.
#

AsanaApi.GetProjectStatusUpdates

Fetch compact status updates for a given project. Use this tool to retrieve all the compact status update records for a specified project on Asana. This is useful to get a historical or current view of the project's status updates. Note that this endpoint is deprecated for new integrations.

Parameters

ParameterTypeReq.Description
project_global_identifierstringRequiredGlobally unique identifier for the project in Asana.
enable_pretty_outputbooleanOptionalEnable to format the response for readability with line breaks and indentation. Only recommended for debugging due to increased response size and processing time.
include_optional_fieldsarray<string>OptionalComma-separated list of optional properties to include in the response.
pagination_offset_tokenstringOptionalOffset token for pagination. Use the token provided by a previous request to retrieve the next page of results.
results_per_pageintegerOptionalNumber of status updates to return per page, must be between 1 and 100.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'getProjectStatusesForProject'.
#

AsanaApi.GetProjectTasks

Fetch tasks from a specific Asana project. Retrieves compact task records for all tasks in a given Asana project, ordered by their priority. Useful for accessing and managing task lists.

Parameters

ParameterTypeReq.Description
project_global_idstringRequiredGlobally unique identifier for the Asana project. Required to retrieve tasks from a specific project.
completed_sincestringOptionalReturn tasks incomplete or completed after this date-time or 'now'.
enable_pretty_outputbooleanOptionalEnable pretty formatting for the response. This makes the output more readable but increases response size and time. Useful for debugging.
include_optional_fieldsarray<string>OptionalComma-separated list of optional properties to include in the response.
pagination_offset_tokenstringOptionalToken for paginating results. Use it to retrieve the next set of tasks from a previously returned offset.
results_per_pageintegerOptionalNumber of task records to return per page in the result. Must be between 1 and 100.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'getTasksForProject'.
#

AsanaApi.GetProjectTemplateDetails

Retrieve complete details of a specific Asana project template. Fetches all information about a particular project template in Asana. Useful for obtaining full details of a project's structure and specifications.

Parameters

ParameterTypeReq.Description
project_template_idstringRequiredGlobally unique identifier for the project template to fetch complete details.
include_optional_propertiesarray<string>OptionalList properties to include in the response. Exclude default properties, using a comma-separated format.
pretty_output_enabledbooleanOptionalSet to true to receive a formatted and readable response output, suitable for debugging. Increases response time and size.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'getProjectTemplate'.
#

AsanaApi.GetProjectTemplatesForTeam

Retrieve compact project template records for a team. Call this tool to get a list of project templates for a specified team in Asana. It requires the 'project_templates:read' scope.

Parameters

ParameterTypeReq.Description
team_idstringRequiredGlobally unique identifier for the team to retrieve project templates.
enable_pretty_outputbooleanOptionalEnable to get the response in a readable, "pretty" JSON format. Useful for debugging.
include_optional_propertiesarray<string>OptionalComma-separated list of optional properties to include in the response. Specify any properties excluded by default that you wish to see.
pagination_offset_tokenstringOptionalOffset token to fetch the next page of results. Use the token returned from a previous request's pagination.
results_per_pageintegerOptionalNumber of project templates to return per page. Must be between 1 and 100.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'getProjectTemplatesForTeam'.
#

AsanaApi.GetStatusUpdatesForObject

Retrieve status updates for a specified object in Asana. Use this tool to get the compact status update records for all updates related to a specific object in Asana. It is helpful for tracking changes or updates on any Asana object.

Parameters

ParameterTypeReq.Description
object_gidstringRequiredGlobally unique identifier (GID) for the Asana object (project, portfolio, or goal) to fetch status updates from.
created_since_timestringOptionalReturn statuses created after the specified time. Use ISO 8601 format.
enable_pretty_outputbooleanOptionalEnable pretty JSON output with line breaks and indentation for readability. Mainly used for debugging, as it increases response size.
optional_fields_to_includearray<string>OptionalList the optional properties to include in the response. Provide as a comma-separated list of property names.
pagination_offset_tokenstringOptionalToken to fetch the next page of results. Use an offset returned from a previous paginated request.
results_per_pageintegerOptionalNumber of results to return per page. Must be between 1 and 100.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'getStatusesForObject'.
#

AsanaApi.GetTagsForTask

Retrieve all tags for a given task. Use this tool to get a list of tags linked to a specific task in Asana. It requires the 'tags:read' scope to access the data.

Parameters

ParameterTypeReq.Description
task_identifierstringRequiredThe unique identifier of the task to retrieve tags for in Asana.
enable_pretty_outputbooleanOptionalSet to true to receive the response in a formatted, readable form. Useful for debugging as it increases response size and time.
include_optional_fieldsarray<string>OptionalList of optional properties to include in the response as comma-separated values.
pagination_offset_tokenstringOptionalAn offset token for paginating results. Use the token from a previous response to access subsequent pages.
results_per_pageintegerOptionalNumber of objects to return per page. Must be between 1 and 100.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'getTagsForTask'.
#

AsanaApi.GetTaskCountsForProject

Retrieve task count details for a specific project in Asana. Use this tool to get detailed counts of tasks, including total, incomplete, and completed tasks, for a specific project in Asana. Ensure the necessary scopes are granted: `projects:read`, and optionally `custom_fields:read` and `teams:read`. Opt in to specific fields to retrieve data, considering rate and cost limits.

Parameters

ParameterTypeReq.Description
project_global_idstringRequiredGlobally unique identifier for the project in Asana.
enable_pretty_outputbooleanOptionalSet to true to format the response in a readable way with line breaks and indentation. Use for debugging due to increased response size.
include_optional_fieldsarray<string>OptionalComma-separated list of properties to include in the response. Opt-in to get specific data fields from the endpoint.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'getTaskCountsForProject'.
#

AsanaApi.GetTaskDependencies

Retrieve all dependencies for a specific Asana task. This tool is used to get all dependencies associated with a specific task in Asana. It should be utilized when there's a need to understand the dependencies that a task has, requiring tasks:read scope.

Parameters

ParameterTypeReq.Description
task_idstringRequiredThe global ID of the task to retrieve dependencies for in Asana.
enable_pretty_outputbooleanOptionalEnable pretty formatting for output; useful for debugging. Increases response size and time.
included_fieldsarray<string>OptionalComma-separated list of properties to include in the response. Some properties are excluded by default.
pagination_offset_tokenstringOptionalThe offset token for pagination, used to retrieve the next page of results. Pass this only if paginating a previous request.
results_per_pageintegerOptionalSpecify the number of task dependencies to return per page. Must be between 1 and 100.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'getDependenciesForTask'.
#

AsanaApi.GetTaskDependents

Retrieve the dependents of a specific task. Use this tool to obtain a list of all tasks dependent on a specified task in Asana. This tool requires the 'tasks:read' scope.

Parameters

ParameterTypeReq.Description
task_identifierstringRequiredThe unique identifier of the task to retrieve dependents for.
enable_pretty_outputbooleanOptionalEnable this for JSON responses with readable line breaks and indentation. Use mainly for debugging.
include_optional_fieldsarray<string>OptionalA list of optional properties to include in the response, specified as strings.
pagination_offsetstringOptionalOffset token for paginated results. Use a token from a previous response to continue fetching results. Defaults to the first page if not provided.
results_per_pageintegerOptionalNumber of results to return per page, between 1 and 100.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'getDependentsForTask'.
#

AsanaApi.GetTaskDetails

Fetch detailed information for a specific Asana task. Retrieves the complete task record for a specified task in Asana. This includes information such as memberships and actual time spent, depending on permissions. Useful for getting comprehensive task data for project management and tracking purposes.

Parameters

ParameterTypeReq.Description
task_identifierstringRequiredSpecify the unique identifier of the Asana task to retrieve detailed information.
enable_pretty_outputbooleanOptionalSet to true for a prettily formatted response, which may increase response time and size. Best used for debugging.
include_optional_propertiesarray<string>OptionalSpecify optional task properties to include in the response. Use a list of strings representing property names.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'getTask'.
#

AsanaApi.GetTasksForSection

Fetch tasks for a specific section in Asana. Use this tool to retrieve all tasks within a given section in Asana's board view. Requires 'tasks:read' scope.

Parameters

ParameterTypeReq.Description
section_unique_identifierstringRequiredThe globally unique identifier for the section in Asana to fetch tasks from. Required to specify the exact section targeted.
completed_since_filterstringOptionalReturn tasks incomplete or completed since a specific time. Use a date-time string or 'now'.
enable_pretty_outputbooleanOptionalEnable pretty formatting of the response for readability. Increases response time and size. Use mainly for debugging.
optional_fields_to_includearray<string>OptionalComma-separated list of optional properties to include in the response.
pagination_offsetstringOptionalOffset token for pagination. Use it to fetch the next page of results. If not provided, the first page will be returned.
results_per_pageintegerOptionalNumber of tasks to return per page, between 1 and 100.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'getTasksForSection'.
#

AsanaApi.GetTasksForTag

Retrieve tasks associated with a specific tag in Asana. Use this tool to get a list of tasks that are associated with a specific tag in Asana. This can help organize tasks that share common attributes or objectives. Useful for managing tasks by category or project requirements.

Parameters

ParameterTypeReq.Description
tag_global_idstringRequiredGlobally unique identifier for the tag to retrieve associated tasks.
enable_pretty_outputbooleanOptionalFormats the response for readability with line breaks and indentation. Use true only during debugging due to increased response size.
optional_fields_to_includearray<string>OptionalList of optional property names to include in the response for each task (comma-separated).
pagination_offsetstringOptionalA token for pagination to fetch the next set of results. Use the token returned from a previous call for fetching subsequent pages. If not provided, the first page of results is returned.
results_per_pageintegerOptionalThe number of task objects to return per page, ranging from 1 to 100.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'getTasksForTag'.
#

AsanaApi.GetTaskStories

Retrieve all stories for a specified Asana task. This tool fetches all compact records for stories associated with a specific task in Asana, requiring the 'stories:read' scope.

Parameters

ParameterTypeReq.Description
task_identifierstringRequiredThe unique identifier for the task to retrieve stories from.
enable_pretty_outputbooleanOptionalSet to true for a readable, pretty format with line breaks and indentation. Useful for debugging. This will increase response time and size.
include_optional_fieldsarray<string>OptionalList of optional resource properties to include, specified as an array of strings.
pagination_offsetstringOptionalAn offset token for paginating through results. Use a token returned from a previous API call to access subsequent pages. If not provided, the first page is returned.
results_per_pageintegerOptionalSpecify the number of stories to return per page, between 1 and 100.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'getStoriesForTask'.
#

AsanaApi.GetTaskSubtasks

Retrieve subtasks for a specific task in Asana. Use this tool to get a list of subtasks for a given task in Asana. Useful when you need to see all the subtasks associated with a task to track progress or manage workflow.

Parameters

ParameterTypeReq.Description
task_idstringRequiredThe unique identifier of the task to retrieve subtasks for.
enable_pretty_outputbooleanOptionalEnable to receive the response in a 'pretty' format with line breaks and indentation. Useful for debugging. May increase response time and size.
include_optional_fieldsarray<string>OptionalComma-separated list of optional properties to include in the response.
pagination_offsetstringOptionalAn offset token for pagination to retrieve the next page of results. Pass the token from a previous paginated request. If not provided, the first page is returned.
results_per_pageintegerOptionalSpecify the number of subtasks to return per page. Must be between 1 and 100.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'getSubtasksForTask'.
#

AsanaApi.GetTeamMembership

Retrieve complete details for a team membership. Use this tool to obtain the full team membership record for a specific team membership in Asana. It requires the 'team_memberships:read' scope.

Parameters

ParameterTypeReq.Description
team_membership_idstringRequiredThe unique identifier for the specific team membership to retrieve.
enable_pretty_outputbooleanOptionalEnable pretty formatting for the response with line breaks and indentation. Useful for debugging, but increases response time and size.
include_optional_propertiesarray<string>OptionalA list of optional properties to include in the response, specified as strings.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'getTeamMembership'.
#

AsanaApi.GetTeamMemberships

Retrieve compact team membership records from Asana. Fetches compact records of team memberships from Asana when scope 'team_memberships:read' is required.

Parameters

ParameterTypeReq.Description
enable_pretty_outputbooleanOptionalReturn response in a readable format with line breaks and indentation. Ideal for debugging.
optional_fields_to_includearray<string>OptionalList the properties to include in the response, as some are excluded by default.
pagination_offset_tokenstringOptionalAn offset token for pagination. Use a previously returned token to access subsequent pages. If omitted, the first page is returned.
results_per_pageintegerOptionalSpecify the number of results to return per page. Must be between 1 and 100.
team_identifierstringOptionalGlobally unique identifier for the team in Asana.
user_identifierstringOptionalA string identifying a user. Use 'me', an email, or a user gid. Must be used with 'workspace'.
workspace_idstringOptionalGlobally unique identifier for the workspace. This parameter must be used with the user_id parameter.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'getTeamMemberships'.
#

AsanaApi.GetTeamProjects

Fetch the list of projects for a specified team. This tool retrieves the compact project records for all projects within a specified team. It should be used when you need to access or display project details for a given team in Asana. Requires the 'projects:read' scope.

Parameters

ParameterTypeReq.Description
team_identifierstringRequiredGlobally unique identifier for the team whose projects are to be retrieved. It is required to specify the team.
enable_pretty_outputbooleanOptionalEnable pretty formatting for the response, making it more readable. Use mainly for debugging due to increased response size.
include_optional_propertiesarray<string>OptionalA list of optional properties to include in the response for the projects. Specify as a list of strings.
only_archived_projectsbooleanOptionalReturn projects based on their archived status. True for archived projects, False for non-archived projects.
pagination_offset_tokenstringOptionalOffset token used for pagination to fetch the next page of results. If not provided, the first page is returned. Use an offset from a previous response for subsequent pages.
results_per_pageintegerOptionalNumber of projects to return per page, between 1 and 100.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'getProjectsForTeam'.
#

AsanaApi.GetTeamUsersAsana

Retrieve user records for a specific Asana team. This tool fetches the compact records of all users who are members of a specified Asana team. It should be called to obtain a list of team members, sorted alphabetically, with a limit of 2000 users.

Parameters

ParameterTypeReq.Description
team_global_identifierstringRequiredGlobally unique identifier for the Asana team to retrieve users from.
enable_pretty_outputbooleanOptionalEnable pretty output with line breaks and indentation for readability. Recommended for debugging as it increases response time and size.
include_optional_fieldsarray<string>OptionalComma-separated list of properties you wish to include in the response. These are excluded by default.
pagination_offset_tokenstringOptionalOffset token for pagination. Use this token from a previous response to fetch the next page of results.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'getUsersForTeam'.
#

AsanaApi.GetTimePeriodRecord

Retrieve detailed information for a specific time period. Use this tool to get the full record of a single time period by specifying its identifier.

Parameters

ParameterTypeReq.Description
time_period_idstringRequiredGlobally unique identifier for the time period to retrieve its record.
enable_pretty_outputbooleanOptionalEnable pretty formatting for output. Use only for debugging as it increases response size and processing time.
include_optional_propertiesarray<string>OptionalList of property names to include in the response. These properties are excluded by default.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'getTimePeriod'.
#

AsanaApi.GetTimePeriods

Retrieve compact time period records from Asana. Use this tool to access and retrieve compact time period records from Asana's service when you need to handle or analyze time-related data.

Parameters

ParameterTypeReq.Description
workspace_idstringRequiredGlobally unique identifier for the Asana workspace.
enable_pretty_outputbooleanOptionalSet to true to receive formatted, readable output mainly for debugging, increasing response size.
end_datestringOptionalThe end date for time periods in ISO 8601 format. Specify the last date to include in the returned results.
include_optional_propertiesarray<string>OptionalA list of optional property names to include in the response, specified as an array of strings.
pagination_offsetstringOptionalOffset token for pagination. Use the offset from a previous API response to retrieve the next page of results. If omitted, the first page is returned.
results_per_pageintegerOptionalThe number of results to return per page, from 1 to 100.
start_datestringOptionalStart date for the time period in ISO 8601 format. Determines the beginning of the time period records to be retrieved.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'getTimePeriods'.
#

AsanaApi.GetTimeTrackingEntries

Retrieve time tracking entries for a specified task. Use this tool to get detailed time tracking entries associated with a specific task in Asana. It should be called when you need to analyze or review the time spent on a task by different users.

Parameters

ParameterTypeReq.Description
task_idstringRequiredThe unique identifier for the task to retrieve time tracking entries for.
enable_pretty_outputbooleanOptionalSet to true for a readable, pretty-formatted output. Recommended for debugging as it may increase response time and size.
include_optional_fieldsarray<string>OptionalComma-separated list of optional properties to include in the response, enhancing the returned resource details.
pagination_offsetstringOptionalToken for pagination; use to retrieve the next set of results. If not provided, the first page is returned.
results_per_pageintegerOptionalNumber of time tracking entries to return per page, must be between 1 and 100.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'getTimeTrackingEntriesForTask'.
#

AsanaApi.GetTimeTrackingEntry

Retrieve a time tracking entry from Asana. Use this tool to obtain the complete record of a specific time tracking entry in Asana. This should be called when detailed information about a particular time tracking task is needed.

Parameters

ParameterTypeReq.Description
time_tracking_entry_idstringRequiredGlobally unique identifier for the time tracking entry. Used to specify which entry to retrieve.
enable_pretty_outputbooleanOptionalEnable to get the response in a readable format with line breaks and indentation. Use only for debugging, as it may increase response time and size.
include_optional_propertiesarray<string>OptionalA list of property names to include as optional fields in the response. Provide properties as strings in a comma-separated format. Default properties are excluded unless explicitly specified here.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'getTimeTrackingEntry'.
#

AsanaApi.GetUserDetails

Retrieve detailed user information from Asana. Use this tool to get the complete user record for a specific user in Asana by providing their user ID. Ensure you have the required scope: users:read.

Parameters

ParameterTypeReq.Description
user_identifierstringRequiredA string to identify a user, which can be 'me', an email, or a user's gid.
enable_pretty_outputbooleanOptionalSet to true to format the response for readability with line breaks and indentation. Recommended for debugging, as it may increase response time and size.
include_optional_propertiesarray<string>OptionalSpecify properties to include in the response using a comma-separated list of strings.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'getUser'.
#

AsanaApi.GetUserFavorites

Retrieve a user's favorites from a specified Asana workspace. This tool retrieves all of a user's favorites within a specified Asana workspace and of a given type. The results are ordered as they appear in the user's Asana sidebar and are limited to the current user associated with the authentication token.

Parameters

ParameterTypeReq.Description
user_identifierstringRequiredString to identify a user: 'me', an email, or a user GID.
workspace_idstringRequiredThe unique identifier of the Asana workspace to retrieve favorites from.
favorites_resource_typestringOptionalSpecifies the type of favorites to return (e.g., 'portfolio', 'project').
include_optional_fieldsarray<string>OptionalSpecify a list of optional properties to include in the response, separated by commas.
pagination_offsetstringOptionalAn offset token for pagination. Use a token returned from a previous request to navigate pages. If not provided, the first page is returned.
pretty_outputbooleanOptionalSet to true for readable, formatted output with line breaks and indentation, ideal for debugging.
results_per_pageintegerOptionalSpecifies the number of objects to return per page, between 1 and 100.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'getFavoritesForUser'.
#

AsanaApi.GetUserOwnedPortfolios

Retrieve a list of portfolios owned by the user. Use this tool to get a list of portfolios owned by the current API user in Asana. This is useful for managing and organizing projects within the user's account.

Parameters

ParameterTypeReq.Description
workspace_identifierstringRequiredThe unique identifier for the workspace or organization to filter portfolios on.
enable_pretty_outputbooleanOptionalEnable pretty formatting for the output, improving readability with line breaks and indentation. This may increase response size and time, suitable for debugging.
include_optional_fieldsarray<string>OptionalComma-separated list of properties to include in the response, allowing retrieval of additional optional fields.
pagination_offset_tokenstringOptionalA token to retrieve the next page of results. Use the offset token from a previous API response for pagination. If omitted, returns the first page.
portfolio_owner_identifierstringOptionalSpecify the user who owns the portfolio. Only applicable if using a Service Account for accessing portfolios owned by different users.
results_per_pageintegerOptionalThe number of portfolios to return per page. Must be between 1 and 100.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'getPortfolios'.
#

AsanaApi.GetUserTaskList

Retrieve tasks in a user's My Tasks list. Fetches a compact list of tasks for a user's My Tasks list from Asana. It includes both complete and incomplete tasks unless filtered. Access control applies, so private tasks are excluded if the authenticated user lacks permissions.

Parameters

ParameterTypeReq.Description
user_task_list_idstringRequiredGlobally unique identifier for the user's task list. This ID is required to fetch tasks from the specified user list.
enable_pretty_outputbooleanOptionalEnable pretty output to make the JSON response more readable. This increases response time and size, so it's recommended for debugging only.
filter_completed_tasks_sincestringOptionalReturn only tasks that are either incomplete or completed since this date-time or the keyword 'now'.
include_optional_fieldsarray<string>OptionalList the optional properties to include in the response, as a list of strings. These properties are excluded by default.
pagination_offset_tokenstringOptionalOffset token for pagination. Use the token returned from a previous request to fetch the next page. If not provided, the first page is returned.
tasks_per_pageintegerOptionalSpecify the number of tasks to return per page, between 1 and 100.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'getTasksForUserTaskList'.
#

AsanaApi.GetUserTeamMemberships

Retrieve team membership records for a specific user. This tool returns the compact team membership records for a specified user in Asana. It should be called when you need to obtain information about a user's team memberships. Requires 'team_memberships:read' scope.

Parameters

ParameterTypeReq.Description
user_identifierstringRequiredA string identifying a user, which can be 'me', an email, or the user's gid.
workspace_identifierstringRequiredGlobally unique identifier for the workspace in Asana.
enable_pretty_outputbooleanOptionalEnable pretty formatting for the response output with line breaks and indentation, useful for debugging. It increases response size and time.
include_optional_fieldsarray<string>OptionalA list of optional properties to include in the response, specified as strings. Use to get excluded fields.
pagination_offsetstringOptionalOffset token for pagination. Use the offset to get the next page of results, returned from a previous paginated request.
results_per_pageintegerOptionalNumber of records to return per page, ranging from 1 to 100.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'getTeamMembershipsForUser'.
#

AsanaApi.GetUserWorkspaceMemberships

Fetches a user's workspace membership records in Asana. Use this tool to obtain compact workspace membership details for a specific user in Asana. Call this tool when you need to understand which workspaces a user is associated with.

Parameters

ParameterTypeReq.Description
user_identifierstringRequiredString identifying a user. Use 'me', an email, or a user gid.
enable_pretty_outputbooleanOptionalIf true, provides the response in a readable, pretty format with line breaks and indentation. Useful for debugging.
include_optional_fieldsarray<string>OptionalComma-separated list of optional user properties to include in the response.
page_offset_tokenstringOptionalToken to fetch the next page of results from a paginated request. Use a token returned from a previous response.
results_per_pageintegerOptionalNumber of objects to return per page, between 1 and 100.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'getWorkspaceMembershipsForUser'.
#

AsanaApi.GetVisibleWorkspaces

Retrieve all workspaces visible to the user. Fetches a list of compact records for all workspaces the authorized user can see, requiring the 'workspaces:read' scope.

Parameters

ParameterTypeReq.Description
enable_pretty_outputbooleanOptionalEnable for pretty, readable response. Ideal for debugging as it increases response time and size.
include_optional_propertiesarray<string>OptionalComma-separated list of optional fields to include in the response. Use this to include properties that are excluded by default.
pagination_offsetstringOptionalAn offset token for paginating through the results. Use the token returned from a previous request to access the next page.
results_limit_per_pageintegerOptionalSpecify the number of workspaces to return per page. Must be between 1 and 100.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'getWorkspaces'.
#

AsanaApi.GetWorkspaceDetails

Retrieve detailed information about a specific Asana workspace. Use this tool to get the full record of a specific workspace in Asana by providing the workspace ID. It requires the 'workspaces:read' scope.

Parameters

ParameterTypeReq.Description
workspace_global_idstringRequiredGlobally unique identifier for the Asana workspace or organization.
enable_pretty_outputbooleanOptionalEnable this to provide a response with pretty formatting, including line breaks and indentation. Recommended for debugging due to increased response size and time.
include_optional_propertiesarray<string>OptionalList the optional properties to include, as a comma-separated list, to extend the default fields in the workspace record.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'getWorkspace'.
#

AsanaApi.GetWorkspaceEvents

Retrieve all events in a workspace since a specific sync token. Use this tool to get a full record of events that have occurred in an Asana workspace since a specified sync token. If the number of events exceeds 1000, the response will indicate there are more events to retrieve.

Parameters

ParameterTypeReq.Description
workspace_global_idstringRequiredGlobally unique identifier for the workspace or organization in Asana.
enable_pretty_outputbooleanOptionalEnable pretty output for better readability. Recommended for debugging as it increases response size and takes extra time.
sync_tokenstringOptionalA sync token received from the last request to fetch events from a specific point in time. Omit on first sync to receive a new token.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'getWorkspaceEvents'.
#

AsanaApi.GetWorkspaceMembership

Get the complete record for a workspace membership. Use this tool to retrieve detailed information about a specific workspace membership in Asana.

Parameters

ParameterTypeReq.Description
workspace_membership_idstringRequiredThe unique identifier for the workspace membership to retrieve.
enable_pretty_outputbooleanOptionalSet to true for "pretty" JSON formatting with line breaks and indentation. Increases response time and size; use for debugging.
include_optional_propertiesarray<string>OptionalList of specific properties to include in the response, as some are excluded by default.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'getWorkspaceMembership'.
#

AsanaApi.GetWorkspaceMemberships

Retrieve workspace membership records. This tool calls Asana's API to fetch compact workspace membership records for a specified workspace. It should be used when you need to list or check members of a workspace.

Parameters

ParameterTypeReq.Description
workspace_global_idstringRequiredA globally unique identifier for the workspace or organization to fetch memberships for.
enable_pretty_outputbooleanOptionalEnable pretty output with line breaks and indentation for debugging purposes.
include_optional_fieldsarray<string>OptionalAn array of strings specifying optional properties to include in the response.
pagination_offsetstringOptionalOffset token for pagination to retrieve the next page of results. Use the token returned from a previous call for continuous paging, or leave empty for the first page.
results_per_pageintegerOptionalSpecify the number of membership records to return per page, from 1 to 100.
user_identifierstringOptionalA string to identify a user, such as 'me', an email, or a user's gid in Asana.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'getWorkspaceMembershipsForWorkspace'.
#

AsanaApi.GetWorkspaceProjects

Fetch compact project records for a workspace. This tool retrieves the compact project records for all projects in a specified workspace from Asana. It should be called when you need to access project information within a workspace. Note: May timeout for large domains; consider using the `/teams/{team_gid}/projects` endpoint for efficiency.

Parameters

ParameterTypeReq.Description
workspace_identifierstringRequiredGlobally unique identifier for the workspace or organization in Asana.
archived_projects_onlybooleanOptionalSpecify `true` to return only archived projects, and `false` to include unarchived ones.
enable_pretty_outputbooleanOptionalEnable pretty formatting for the response output. Use this for a readable JSON format, mainly during debugging.
optional_fields_to_includearray<string>OptionalSpecify a list of property names to include in the response. These properties are not included by default.
pagination_offset_tokenstringOptionalOffset token for pagination. Use to request subsequent pages. If omitted, returns the first page. Only use tokens from previous requests.
results_per_pageintegerOptionalSpecify the number of project records to return per page. Must be between 1 and 100.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'getProjectsForWorkspace'.
#

AsanaApi.GetWorkspaceUsers

Retrieve all users from a specified workspace. Fetches compact records for all users in a specific Asana workspace or organization. Suitable for retrieving member lists sorted alphabetically, limited to 2000 users.

Parameters

ParameterTypeReq.Description
workspace_unique_idstringRequiredGlobally unique identifier for the workspace or organization in Asana.
enable_pretty_outputbooleanOptionalSet to true for a "pretty" response with indentation and line breaks. Recommended for debugging as it increases response size and time.
include_optional_fieldsarray<string>OptionalList properties to include in the response. Provide these as an array of strings to retrieve additional user information beyond the default fields.
pagination_offset_tokenstringOptionalAn offset token used for paginating results. It allows you to retrieve the next page of results by using a token returned from a previous request. If omitted, the first page is returned.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'getUsersForWorkspace'.
#

AsanaApi.InitiateBulkResourceExport

Initiate a bulk export of tasks, teams, or messages in a workspace. Use this tool to start exporting tasks, teams, or messages from a workspace in Asana. The export is processed asynchronously, and results can be monitored using the jobs endpoint. The export includes attachments and stories by default, with options to specify fields and apply filters. The final export file is in JSON Lines format, compressed in a gzip container. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'createResourceExport'.
#

AsanaApi.InitiateGraphExport

Initiate a graph export job for Asana objects. Initiates a graph export job for a specified Asana goal, team, portfolio, or project. The export is processed asynchronously. Use the jobs endpoint to monitor progress. Caching occurs for exports exceeding 1,000 tasks, lasting 4 hours.

Parameters

ParameterTypeReq.Description
parent_object_idstringOptionalGlobally unique ID of the Asana parent object: goal, project, portfolio, or team.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'createGraphExport'.
#

AsanaApi.InstantiateProjectFromTemplate

Asynchronously instantiate a project from a template. This tool creates a job to asynchronously handle project instantiation using a specified project template. It should be called when you need to create a new project from an existing template in Asana. Ensure you have the 'projects:write' scope and verify if your workspace is an organization. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires path, query parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required path, query parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
project_template_idstringOptionalGlobally unique identifier for the project template to instantiate the project from. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
include_optional_propertiesarray<string>OptionalA list of optional properties to include in the response. Provide as a comma-separated list. Only used when mode is 'execute'.
enable_pretty_outputbooleanOptionalEnable pretty formatting for the response. Use this for debugging purposes as it increases response time and size. Only used when mode is 'execute'.
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'instantiateProject'.
#

AsanaApi.MoveSectionInProject

Reorder sections within a project in Asana. Use this tool to move sections relative to each other within a single Asana project. Either 'before_section' or 'after_section' must be specified. This tool does not support moving sections between different projects.

Parameters

ParameterTypeReq.Description
project_global_idstringRequiredGlobally unique identifier for the project in Asana.
enable_pretty_outputbooleanOptionalIf true, enables pretty output with line breaks and indentation for readability. Use primarily for debugging, as it may increase response time and size.
insert_after_section_idstringOptionalThe ID of the section after which the given section will be inserted. Specify to reorder sections within the same project.
insert_before_section_idstringOptionalSpecify the section ID to place the given section immediately before it.
section_to_reorderstringOptionalGlobally unique identifier for the section to move within the project.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'insertSectionForProject'.
#

AsanaApi.RejectAccessRequest

Reject an access request for a target object. This tool should be called when you need to reject a pending access request for a specific target object in Asana. Use it to manage access control effectively by denying requests as needed.

Parameters

ParameterTypeReq.Description
access_request_identifierstringRequiredGlobally unique identifier for the access request to be rejected. This value is required for identifying which access request to reject in Asana.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'rejectAccessRequest'.
#

AsanaApi.RemoveCustomFieldFromPortfolio

Removes a custom field from an Asana portfolio. Use this tool to remove a custom field setting from a specific portfolio in Asana. Useful when you need to update portfolio configurations by eliminating unnecessary custom fields.

Parameters

ParameterTypeReq.Description
portfolio_global_idstringRequiredGlobally unique identifier for the portfolio to identify which portfolio the custom field should be removed from.
custom_field_id_to_removestringOptionalThe unique identifier of the custom field to be removed from the portfolio.
enable_pretty_outputbooleanOptionalEnable pretty format for the output, adding line breaks and indentation for readability. Increases response size and processing time, recommended for debugging.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'removeCustomFieldSettingForPortfolio'.
#

AsanaApi.RemoveCustomFieldFromProject

Remove a custom field setting from an Asana project. Use this tool to remove a custom field setting from a specified project in Asana. This requires the 'projects:write' scope.

Parameters

ParameterTypeReq.Description
project_unique_idstringRequiredGlobally unique identifier for the Asana project.
custom_field_id_to_removestringOptionalThe ID of the custom field to remove from the specified project in Asana.
enable_pretty_outputbooleanOptionalFormats the response in a readable way with line breaks and indentation. Use for debugging as it increases response time and size.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'removeCustomFieldSettingForProject'.
#

AsanaApi.RemoveFollowersFromProject

Remove specified users from following a project in Asana. This tool removes a list of specified users from following a project in Asana without affecting their membership status. It should be called when you want to update who follows a project without altering project membership.

Parameters

ParameterTypeReq.Description
project_global_idstringRequiredGlobally unique identifier for the project in Asana.
enable_pretty_outputbooleanOptionalSet to true to format the response with line breaks and indentation for readability. Useful for debugging.
include_optional_propertiesarray<string>OptionalA list of property names to include in the response, specified as strings. This should be used to include properties that are not returned by default.
user_identifiers_to_unfollowstringOptionalArray of user identifiers (e.g. "me", email, or gid) to remove from following the project.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'removeFollowersForProject'.
#

AsanaApi.RemoveGoalFollowers

Remove followers from a specific goal in Asana. Use this tool to remove followers from a goal in Asana. It returns the complete updated goal record with the followers removed. Ideal for managing team members involved with specific goals.

Parameters

ParameterTypeReq.Description
goal_unique_idstringRequiredGlobally unique identifier for the goal to remove followers from.
enable_pretty_outputbooleanOptionalEnable pretty JSON output with line breaking and indentation. Useful for debugging; increases response time and size.
followers_to_removearray<string>OptionalAn array of user identifiers to remove as followers. These can be "me", an email, or a user gid.
included_optional_fieldsarray<string>OptionalComma-separated list of optional properties to include in the response for additional details.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'removeFollowers'.
#

AsanaApi.RemoveGoalRelationship

Removes a supporting relationship from a goal in Asana. Use this tool to remove a specified supporting relationship from a parent goal in Asana. It is useful for managing and updating the hierarchical organization of goals.

Parameters

ParameterTypeReq.Description
goal_global_idstringRequiredGlobally unique identifier for the goal to identify which goal is being modified.
provide_pretty_outputbooleanOptionalProvides pretty-printed output for debugging, enhancing readability with line breaks and indentation. Increases response size and time.
supporting_resource_gidstringOptionalThe globally unique identifier (gid) of the supporting resource (goal, project, task, or portfolio) to remove from the parent goal.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'removeSupportingRelationship'.
#

AsanaApi.RemoveItemFromPortfolio

Remove an item from a portfolio in Asana. Use this tool to remove an item from a specified portfolio in Asana. Requires the 'portfolios:write' scope.

Parameters

ParameterTypeReq.Description
portfolio_identifierstringRequiredGlobally unique identifier for the portfolio to remove the item from.
enable_pretty_outputbooleanOptionalEnable this to receive the response in a readable, formatted way. This can increase response size and is best for debugging.
item_to_removestringOptionalSpecify the ID of the item to be removed from the portfolio.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'removeItemForPortfolio'.
#

AsanaApi.RemoveMembersFromProject

Remove specified users from a project in Asana. This tool calls the Asana API to remove a list of specified users from the members of a project. It returns the updated project record after the removal operation.

Parameters

ParameterTypeReq.Description
project_identifierstringRequiredGlobally unique identifier for the project.
enable_pretty_outputbooleanOptionalSet to true for formatted, human-readable JSON. Increases response size; use for debugging.
include_optional_fieldsarray<string>OptionalA list of optional fields to include in the response. Use a comma-separated list to specify.
user_identifiersstringOptionalArray of user identifiers to be removed from the project. Accepts "me", email, or user gid.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'removeMembersForProject'.
#

AsanaApi.RemovePortfolioMembers

Remove specified members from a portfolio. Use this tool to remove a list of users from the members of a specific Asana portfolio. The tool returns the updated portfolio record after the members have been removed.

Parameters

ParameterTypeReq.Description
portfolio_unique_idstringRequiredGlobally unique identifier for the portfolio to modify. Required for removing members.
enable_pretty_outputbooleanOptionalEnable to format the response with line breaks and indentation for readability. Recommended only for debugging.
include_optional_propertiesarray<string>OptionalComma-separated list of properties to include in the response, allowing for additional data retrieval.
members_to_removestringOptionalList of user identifiers to remove from the portfolio. Use 'me', an email, or user gid.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'removeMembersForPortfolio'.
#

AsanaApi.RemoveTagFromTask

Remove a tag from a task in Asana. Use this tool to remove a specific tag from a task in Asana. This action requires write access to tasks.

Parameters

ParameterTypeReq.Description
task_identifierstringRequiredThe unique identifier of the task from which the tag should be removed.
enable_pretty_outputbooleanOptionalIf true, formats the response for readability with line breaks and indentation. Use primarily for debugging.
tag_gid_to_removestringOptionalThe GID of the tag to be removed from the task in Asana.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'removeTagForTask'.
#

AsanaApi.RemoveTaskDependencies

Unlink dependencies from a specified task on Asana. Use this tool to remove a set of dependencies from a given task in Asana. Requires 'tasks:write' access scope.

Parameters

ParameterTypeReq.Description
task_idstringRequiredThe unique identifier of the task to operate on for removing dependencies.
enable_pretty_outputbooleanOptionalSet to true to receive a formatted, readable response. Useful for debugging, but increases response size and time.
task_dependency_ids_to_removearray<string>OptionalAn array of task GIDs representing dependencies to be removed from the specified task.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'removeDependenciesForTask'.
#

AsanaApi.RemoveTaskDependents

Unlink dependents from an Asana task. Use this tool to unlink a set of dependents from a specific task in Asana. This is useful when you need to adjust task dependencies within your project management workflow.

Parameters

ParameterTypeReq.Description
task_idstringRequiredThe unique identifier of the task to operate on.
dependents_task_idsarray<string>OptionalAn array of task GIDs that should be unlinked from the specified task.
enable_pretty_outputbooleanOptionalSet to true for prettified JSON output. Recommended only for debugging as it increases response size and time.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'removeDependentsForTask'.
#

AsanaApi.RemoveTaskFromProject

Remove a task from the specified project in Asana. Removes a task from a specified project within Asana. The task continues to exist in the system but will no longer be associated with the project. Requires 'tasks:write' scope.

Parameters

ParameterTypeReq.Description
task_identifierstringRequiredThe unique identifier of the task to remove from the project.
enable_pretty_outputbooleanOptionalEnable 'pretty' response formatting. Provides line breaks and indentation for readability, useful mainly for debugging.
project_to_remove_task_fromstringOptionalThe identifier of the project from which the task will be removed.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'removeProjectForTask'.
#

AsanaApi.RemoveUserFromTeam

Removes a user from a specified Asana team. Use this tool to remove a user from an Asana team. The request must be made by someone who is a member of the team.

Parameters

ParameterTypeReq.Description
team_global_identifierstringRequiredGlobally unique identifier for the team to remove a user from.
enable_pretty_outputbooleanOptionalEnable pretty JSON formatting for the response. This increases readability but also response size, so it's advisable for debugging.
user_identifierstringOptionalA string identifying the user to be removed. It can be 'me', an email, or the user's gid.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'removeUserForTeam'.
#

AsanaApi.RemoveUserFromWorkspace

Remove a user from an Asana workspace or organization. Use this tool to remove a user from a specified workspace or organization in Asana. The caller must be an admin in the workspace. The user can be identified by their user ID or email. Different token types (Service Account Token or Personal Access Token) affect post-removal behaviors, such as resource ownership transfer.

Parameters

ParameterTypeReq.Description
workspace_identifierstringRequiredGlobally unique identifier for the workspace or organization in Asana.
enable_pretty_outputbooleanOptionalEnable to receive formatted and more readable output. Use for debugging due to increased response size and time.
user_identifierstringOptionalIdentifies the user to be removed. Accepts 'me', an email, or a globally unique user ID.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'removeUserForWorkspace'.
#

AsanaApi.ReorderEnumOptionCustomField

Reorder enum options in a custom field. Moves an enum option within a custom field to a specified position relative to another option. Locked fields can only be edited by the locker.

Parameters

ParameterTypeReq.Description
custom_field_idstringRequiredGlobally unique identifier for the custom field to be modified.
enable_pretty_outputbooleanOptionalEnable pretty output for a more readable JSON response format, useful for debugging.
enum_option_gid_to_relocatestringOptionalThe globally unique identifier (GID) of the enum option to relocate within the custom field.
include_optional_propertiesarray<string>OptionalA list of resource properties to include in the response, which are excluded by default. This should be a list of strings.
insert_after_enum_optionstringOptionalThe ID of an existing enum option after which the new option should be inserted. Cannot be used with 'insert_before_enum_option'.
insert_before_enum_option_gidstringOptionalGID of an existing enum option before which the new option should be inserted. Cannot be used with after_enum_option.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'insertEnumOptionForCustomField'.
#

AsanaApi.RequestOrganizationExport

Submit a request to export an organization in Asana. Use this tool to initiate an organization export request in Asana. The export will be processed by Asana after the request is submitted.

Parameters

ParameterTypeReq.Description
enable_pretty_outputbooleanOptionalEnable to receive the response in a formatted JSON with proper indentation. Increases response size and time; use primarily for debugging.
include_optional_propertiesarray<string>OptionalList of property names to include in the export, separated by commas. Use to include non-default properties.
organization_idstringOptionalGlobally unique identifier for the workspace or organization to be exported in Asana.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'createOrganizationExport'.
#

AsanaApi.RetrieveAuditLogEvents

Retrieve audit log events from your Asana domain. Use this tool to get a list of audit log events captured in your Asana domain. It supports various query parameters for filtering events and provides paginated results. Useful for tracking and auditing activities since October 8th, 2021.

Parameters

ParameterTypeReq.Description
workspace_unique_idstringRequiredGlobally unique identifier for the workspace or organization to filter the audit log events.
actor_id_filterstringOptionalFilter events to those triggered by the actor with this unique ID.
actor_type_filterstringOptionalSpecify the actor type to filter events. Use only if not querying by actor ID.
event_type_filterstringOptionalSpecify the type of events to filter. Refer to the supported audit log events for valid types.
filter_by_resource_idstringOptionalFilter events based on the specific resource ID to retrieve only those associated with this ID.
filter_events_end_timestringOptionalFilter events to include only those created before this date and time (exclusive).
pagination_offsetstringOptionalOffset token to specify the starting point for retrieving the next page of results. Use the token from the previous response to continue paging through results. Leaving this unset will fetch the first page.
results_per_pageintegerOptionalSet the number of audit log events to return per page of results, between 1 and 100.
start_time_filterstringOptionalFilter events created on or after this time (inclusive). Provide in ISO 8601 format.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'getAuditLogEvents'.
#

AsanaApi.RetrievePortfolioMemberships

Retrieve compact portfolio membership records for a portfolio. Call this tool to obtain a list of portfolio membership records associated with a specific portfolio in Asana. Use it when you need to view or manage the members of a portfolio.

Parameters

ParameterTypeReq.Description
portfolio_identifierstringRequiredGlobally unique identifier for the portfolio required to fetch membership records.
enable_pretty_outputbooleanOptionalSet to true to receive a readable, formatted response. Use this primarily for debugging due to increased response size and time.
include_optional_fieldsarray<string>OptionalSpecify a list of optional properties to include, using a comma-separated list.
pagination_offset_tokenstringOptionalOffset token used for pagination to retrieve the next page of results. Use the token returned from a previous request.
results_per_pageintegerOptionalNumber of portfolio memberships to return per page, between 1 and 100.
user_identifierstringOptionalA string identifying a user. This can be 'me', an email, or the user's gid.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'getPortfolioMembershipsForPortfolio'.
#

AsanaApi.RetrieveTaskByCustomId

Retrieve a task using a custom ID in Asana. This tool retrieves details of a task from Asana using a given custom ID shortcode. It requires the necessary scope for accessing task details and may include additional scopes to access related memberships or time tracking information.

Parameters

ParameterTypeReq.Description
task_custom_idstringRequiredThe generated custom ID used to identify a specific task in Asana.
workspace_global_idstringRequiredGlobally unique identifier for the workspace or organization in Asana.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'getTaskForCustomID'.
#

AsanaApi.RetrieveWebhookDetails

Retrieve the full record of a specified webhook. Use this tool to get complete details of a webhook by its ID. Requires webhooks:read scope.

Parameters

ParameterTypeReq.Description
webhook_global_identifierstringRequiredGlobally unique identifier for the webhook to retrieve its full record.
enable_pretty_outputbooleanOptionalEnables pretty output formatting with line breaks and indentation. Use this for debugging, but be aware it increases response time and size.
included_fieldsarray<string>OptionalList of optional properties to include in the response. Provide these as an array of strings.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'getWebhook'.
#

AsanaApi.RetrieveWorkspaceTags

Retrieve tags for a specific workspace in Asana. Use this tool to get compact tag records for a specified workspace in Asana. The tags can be filtered using various parameters.

Parameters

ParameterTypeReq.Description
workspace_identifierstringRequiredGlobally unique identifier for the Asana workspace or organization.
enable_pretty_outputbooleanOptionalEnable pretty JSON output with proper line breaking and indentation intended for debugging. This may increase response time and size.
include_optional_propertiesarray<string>OptionalList of optional tag properties to include, specified as strings. These properties are excluded by default.
offset_tokenstringOptionalThe offset token to retrieve the next page of results. Use a token from a previous response for pagination.
results_per_pageintegerOptionalSpecify the number of tag records to return per page, between 1 and 100.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'getTagsForWorkspace'.
#

AsanaApi.SearchTasksInWorkspace

Search for tasks in an Asana workspace using complex filters. Utilize this tool to perform an advanced search for tasks within a specified Asana workspace. It supports complex filters and is available to premium Asana users. Use it to find tasks with specific criteria, including custom field parameters. Note that pagination needs to be handled manually due to search result variability.

Parameters

ParameterTypeReq.Description
workspace_global_idstringRequiredGlobally unique identifier for the workspace or organization where tasks are searched.
all_tags_filtersstringOptionalComma-separated list of tag IDs to filter tasks that have all specified tags.
assigned_by_user_idsstringOptionalA comma-separated list of user IDs to filter tasks assigned by specific users.
assignee_identifiers_anystringOptionalProvide a comma-separated list of user identifiers for any assignee to include in the search.
before_modified_on_datestringOptionalISO 8601 date string to filter tasks modified before this date.
completed_at_afterstringOptionalSpecify an ISO 8601 datetime string to filter tasks completed after this date and time.
completed_at_before_datetimestringOptionalFilter tasks completed before the specified ISO 8601 datetime.
completed_on_after_datestringOptionalSpecify an ISO 8601 date to filter tasks completed after this date.
completed_on_before_datestringOptionalFilter tasks completed before a specific date using an ISO 8601 date string.
completed_on_datestringOptionalFilter tasks by their completion date using an ISO 8601 date string or `null` for no specific date.
created_after_datestringOptionalSpecify the earliest creation date for tasks using an ISO 8601 date string. Filters tasks created after this date.
created_after_datetimestringOptionalFilter tasks created after this ISO 8601 datetime string.
created_at_beforestringOptionalAn ISO 8601 datetime string to filter tasks created before this date and time.
created_by_usersstringOptionalComma-separated list of user IDs to filter tasks created by specific users.
created_on_before_datestringOptionalFilter tasks created before a specific date using an ISO 8601 date string format.
created_on_datestringOptionalFilter tasks by their creation date using an ISO 8601 date string or `null`.
due_at_after_datetimestringOptionalSpecify the start date and time for tasks due after this point. Use an ISO 8601 datetime string.
due_at_beforestringOptionalAn ISO 8601 datetime string to filter tasks due before this date and time.
due_date_onstringOptionalFilter tasks due on a specific date using an ISO 8601 date string or specify `null` for tasks with no due date.
enable_pretty_outputbooleanOptionalFormats the response with line breaks and indentation for readability. Use for debugging, as it increases response size and processing time.
end_date_before_start_onstringOptionalFilter tasks starting before a specified date, using an ISO 8601 date string.
exclude_assigned_by_usersstringOptionalA comma-separated list of user IDs to exclude tasks assigned by these users.
exclude_assigneesstringOptionalComma-separated list of user identifiers to exclude from the search results.
exclude_created_by_user_idsstringOptionalComma-separated list of user IDs to exclude from the search results.
exclude_followers_by_user_idsstringOptionalComma-separated list of user identifiers to exclude from the followers filter.
exclude_projects_by_idstringOptionalA comma-separated list of project IDs to exclude from the search results.
exclude_sections_by_idstringOptionalComma-separated list of section or column IDs to exclude from the search results.
exclude_tags_by_idsstringOptionalA comma-separated list of tag IDs to exclude from the search results.
exclude_tasks_commented_by_usersstringOptionalComma-separated list of user identifiers to exclude tasks commented on by these users.
excluded_liked_by_user_idsstringOptionalA comma-separated list of user IDs to exclude tasks liked by these users.
filter_by_all_projectsstringOptionalComma-separated list of project IDs to filter tasks that belong to all specified projects.
filter_by_any_follower_idsstringOptionalFilter tasks by providing a comma-separated list of user IDs who are followers of the tasks.
filter_by_any_team_idsstringOptionalComma-separated list of team IDs to filter tasks associated with any of these teams.
filter_due_date_beforestringOptionalSpecify tasks with a due date earlier than this ISO 8601 date string.
filter_modified_date_startstringOptionalStart date to filter tasks modified after this date in ISO 8601 format.
filter_sections_allstringOptionalComma-separated list of section or column IDs to filter tasks by inclusion in all specified sections.
filter_tasks_with_attachmentsbooleanOptionalSet to true to filter tasks that have attachments, and false to include all tasks regardless of attachments.
filter_tasks_with_incomplete_dependenciesbooleanOptionalFilter tasks to those with incomplete dependencies. Use true to apply the filter.
filter_to_completed_tasksbooleanOptionalSet to true to filter and display only completed tasks.
filter_to_incomplete_tasks_with_dependentsbooleanOptionalSet to true to filter tasks to those that are incomplete and have dependents.
include_any_tags_idsstringOptionalComma-separated list of tag IDs to include in the search filter.
include_only_subtasksbooleanOptionalSet to true to include only subtasks in the results, false to include all tasks.
include_sections_in_searchstringOptionalA comma-separated list of section or column IDs to filter tasks in the search.
included_optional_propertiesarray<string>OptionalList of optional properties to include for each returned task. Provide as comma-separated values.
last_modified_onstringOptionalISO 8601 date string or `null` to filter tasks based on the modification date.
modified_after_datetimestringOptionalFilter tasks modified after this ISO 8601 datetime string.
modified_at_before_datestringOptionalFilter tasks modified before this date. Use ISO 8601 datetime format.
portfolio_ids_includedstringOptionalA comma-separated list of portfolio IDs to include in the search.
project_ids_anystringOptionalComma-separated list of project IDs to include in the search.
search_textstringOptionalFull-text search on task names and descriptions within the workspace.
sort_results_ascendingbooleanOptionalSet to true to sort search results in ascending order. Default is false.
start_date_afterstringOptionalAn ISO 8601 date string to filter tasks starting after this date.
start_on_datestringOptionalISO 8601 date string specifying the start date of tasks to be searched, or `null` for unspecified.
task_resource_subtypestringOptionalFilter tasks by their resource subtype, such as 'default_task', 'milestone', or 'approval'.
task_sort_orderstringOptionalSpecify the sorting criteria for the task results. Options include 'due_date', 'created_at', 'completed_at', 'likes', or 'modified_at'. Defaults to 'modified_at'.
tasks_due_after_datestringOptionalSpecify an ISO 8601 date string to filter tasks due after this date.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'searchTasksForWorkspace'.
#

AsanaApi.SubmitAccessRequestAsana

Submit a new access request for Asana projects or portfolios. This tool is used to submit a new access request for accessing a private project or portfolio in Asana. It should be called when a user needs permission to access these private objects.

Parameters

ParameterTypeReq.Description
access_request_messagestringOptionalOptional message providing context or additional information for the access request.
target_gidstringOptionalThe GID of the project or portfolio you are requesting access to in Asana.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'createAccessRequest'.
#

AsanaApi.TriggerAsanaRule

Trigger a rule in Asana using an incoming web request. Use this tool to trigger a specific rule in Asana that is set up with an "incoming web request" trigger. Ideal for automating workflows by executing preset rules on demand. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires path parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required path parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
incoming_web_request_trigger_idstringOptionalThe ID of the incoming web request trigger used to execute the rule in Asana. This is automatically generated for the API endpoint. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'triggerRule'.
#

AsanaApi.UpdateAllocation

Update an existing allocation in Asana. Use this tool to update an existing allocation in Asana by providing specific fields to be changed. Unspecified fields will remain unchanged. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires path, query parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required path, query parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
allocation_global_idstringOptionalGlobally unique identifier for the allocation to be updated. This is required to specify which allocation record to modify. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
include_optional_fieldsarray<string>OptionalComma-separated list of optional properties to include in the response. Only used when mode is 'execute'.
enable_pretty_outputbooleanOptionalSet to true to receive the response in a more readable, formatted JSON output. This increases response size and should be used mainly for debugging purposes. Only used when mode is 'execute'.
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'updateAllocation'.
#

AsanaApi.UpdateAsanaCustomField

Update specific fields of an Asana custom field. Use this tool to update an existing Asana custom field. Only the specified fields in the request will be updated, leaving other fields unchanged. The custom field's type and enum options cannot be modified using this endpoint. Ensure the 'custom_fields:write' scope is granted when invoking this method. Locked fields can only be updated by the user who locked them. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires path, query parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required path, query parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
custom_field_global_idstringOptionalGlobally unique identifier for the custom field to be updated. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
include_optional_propertiesarray<string>OptionalComma-separated list of optional properties to include in the response, as the endpoint excludes some by default. Only used when mode is 'execute'.
pretty_outputbooleanOptionalSet to true to receive a pretty-formatted output with line breaks and indentation. Increases response time and size, suitable for debugging. Only used when mode is 'execute'.
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'updateCustomField'.
#

AsanaApi.UpdateAsanaGoal

Update a specific goal in Asana. Use this tool to update the details of an existing goal in Asana. Only the specified fields in the request will be changed, while others remain unchanged. It returns the fully updated goal record. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires path, query parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required path, query parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
goal_unique_idstringOptionalGlobally unique identifier for the goal to be updated. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
included_goal_propertiesarray<string>OptionalList of optional goal properties to include in the response. Provide as an array of strings. Only used when mode is 'execute'.
enable_pretty_outputbooleanOptionalSet to true to format the response with line breaks and indentation for readability. Mainly for debugging as it increases response size. Only used when mode is 'execute'.
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'updateGoal'.
#

AsanaApi.UpdateAsanaStory

Update an Asana story's details. Use this tool to update the text of a comment story or pin/unpin comment and attachment stories in Asana. Only one of `text` or `html_text` can be updated at a time. Requires 'stories:write' permission. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires path, query parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required path, query parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
story_global_idstringOptionalGlobally unique identifier for the Asana story to be updated. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
include_optional_propertiesarray<string>OptionalComma-separated list of optional properties to include in the response. Defaults to excluding some properties. Only used when mode is 'execute'.
enable_pretty_outputbooleanOptionalSet to true for a readable, formatted response. Use for debugging as it increases response size and time. Only used when mode is 'execute'.
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'updateStory'.
#

AsanaApi.UpdateAsanaTag

Update properties of an Asana tag. Updates specific properties of an Asana tag using the provided tag ID. Specify only the fields you wish to change to avoid overwriting other users' changes. Returns the complete updated tag record. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires path, query parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required path, query parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
tag_global_identifierstringOptionalGlobally unique identifier for the tag to update in Asana. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
include_optional_fieldsarray<string>OptionalList of optional properties to include with the tag resource. Provide as an array of property names. Only used when mode is 'execute'.
enable_pretty_outputbooleanOptionalSet to true to receive the response in a readable format with proper indentation and line breaks. This is advised only for debugging as it increases response size. Only used when mode is 'execute'.
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'updateTag'.
#

AsanaApi.UpdateEnumOption

Update an existing enum option in Asana custom fields. This tool is used to update an existing enum option in Asana custom fields. It's necessary to have the 'custom_fields:write' scope. Locked custom fields can only be updated by the user who locked them.

Parameters

ParameterTypeReq.Description
enum_option_gidstringRequiredThe globally unique identifier for the enum option to update.
enum_option_colorstringOptionalThe color of the enum option. Defaults to 'none' if not provided.
enum_option_enabledbooleanOptionalIndicates if the enum option is selectable for the custom field. Provide 'true' to make it selectable, 'false' otherwise.
enum_option_namestringOptionalThe name of the enum option to be updated.
include_optional_propertiesarray<string>OptionalProvide a list of properties to include in the response, beyond the default set.
pretty_outputbooleanOptionalSet to true to receive the response in a pretty-printed format. Increases response time and size, useful for debugging.
resource_gidstringOptionalGlobally unique identifier for the resource as a string.
resource_typestringOptionalThe base type of the resource, specified as a string. This is necessary for updating the enum option.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'updateEnumOption'.
#

AsanaApi.UpdateGoalMetric

Updates a goal's current metric value in Asana. Use this tool to update the existing metric value of a goal in Asana. It returns the complete updated goal metric record. If the metric does not exist, it will respond with an error.

Parameters

ParameterTypeReq.Description
goal_unique_identifierstringRequiredGlobally unique identifier for the Asana goal to be updated.
current_metric_valuenumberOptionalThe current numeric value of a goal metric. Required if metric type is number.
include_optional_fieldsarray<string>OptionalComma-separated list of optional properties to include in the response.
pretty_outputbooleanOptionalSet to true for a more readable response format, useful for debugging.
resource_base_typestringOptionalThe base type of the resource to update. It must be a string indicating the type of resource.
resource_unique_identifierstringOptionalGlobally unique identifier of the resource in Asana, represented as a string.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'updateGoalMetric'.
#

AsanaApi.UpdateGoalRelationship

Update an existing goal relationship in Asana. Use this tool to update specific fields of an existing goal relationship in Asana. Provide only the fields you wish to change, as unspecified fields will remain unchanged. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires path, query parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required path, query parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
goal_relationship_unique_idstringOptionalThe globally unique identifier for the specific goal relationship to be updated. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
include_optional_propertiesarray<string>OptionalSpecify properties to include in the response. Provide as a list of property names, which will include optional fields in the returned goal relationship. Only used when mode is 'execute'.
enable_pretty_outputbooleanOptionalSet to true for a readable response with indentation. Increases response size/time, recommended for debugging. Only used when mode is 'execute'.
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'updateGoalRelationship'.
#

AsanaApi.UpdateMembership

Update an existing membership in Asana. Use this tool to update fields of an existing membership for goals, projects, portfolios, or custom fields in Asana. Only the provided fields in the data block will be updated, while others remain unchanged.

Parameters

ParameterTypeReq.Description
membership_idstringRequiredGlobally unique identifier for the membership to update.
enable_pretty_outputbooleanOptionalIf true, formats the response for readability with line breaks and indentation, useful for debugging.
member_access_levelstringOptionalSpecify the access level for the member. Valid options depend on the membership type: Goals ('viewer', 'commenter', 'editor', 'admin'), Projects ('admin', 'editor', 'commenter'), Portfolios ('admin', 'editor', 'viewer'), Custom Fields ('admin', 'editor', 'user').

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'updateMembership'.
#

AsanaApi.UpdatePortfolio

Update an existing Asana portfolio. Use this tool to update an existing Asana portfolio. Only the specified fields in the request data will be updated, and any unspecified fields will remain unchanged. Requires the 'portfolios:write' scope. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires path, query parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required path, query parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
portfolio_unique_identifierstringOptionalGlobally unique identifier for the portfolio to be updated. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
include_optional_fieldsarray<string>OptionalA list of optional portfolio properties to include in the response, specified as an array of strings. Only used when mode is 'execute'.
enable_pretty_outputbooleanOptionalProvides formatted and indented output. Use primarily for debugging as it increases response size and processing time. Only used when mode is 'execute'.
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'updatePortfolio'.
#

AsanaApi.UpdateProjectBriefAsana

Update an Asana project brief. Use this tool to update an existing Asana project brief. Specify only the fields to be updated; fields not specified will remain unchanged. Returns the complete updated project brief record. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires path, query parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required path, query parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
project_brief_idstringOptionalGlobally unique identifier for the specific project brief to update. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
include_optional_propertiesarray<string>OptionalSpecify a list of properties to include in the response, separated by commas. Only used when mode is 'execute'.
provide_pretty_outputbooleanOptionalIf true, the response is formatted with line breaks and indentation for readability. Use primarily for debugging. Only used when mode is 'execute'.
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'updateProjectBrief'.
#

AsanaApi.UpdateProjectDetails

Update specific fields of an existing project. Use this tool to update specific fields of an existing project in Asana. Specify only the fields you wish to change to avoid overwriting changes made by others. Returns the fully updated project record. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires path, query parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required path, query parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
project_global_idstringOptionalGlobally unique identifier for the project to be updated. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
include_optional_propertiesarray<string>OptionalComma-separated list of properties to include in the response, showing optional fields by default excluded. Only used when mode is 'execute'.
enable_pretty_outputbooleanOptionalEnable pretty formatting for the response output, making it more readable with line breaks and indentation. Use this primarily for debugging as it increases response size and processing time. Only used when mode is 'execute'.
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'updateProject'.
#

AsanaApi.UpdateSectionNameAsana

Update the name of a specific section in Asana. Use this tool to update the name of an existing section in an Asana project. It specifically changes the `name` field of a section without affecting other fields. Ideal for modifying section titles while preserving other data.

Parameters

ParameterTypeReq.Description
section_global_identifierstringRequiredThe globally unique identifier for the section to be updated in Asana.
include_optional_propertiesarray<string>OptionalComma-separated list of properties to include in the response. Allows inclusion of optional fields excluded by default.
insert_after_section_idstringOptionalIdentifier of an existing section after which the updated section should be inserted. Cannot be used with `insert_before_section_id`.
pretty_outputbooleanOptionalSet to true for a readable, pretty formatted response with line breaks and indentation. Recommended for debugging as it increases response size.
section_insert_before_idstringOptionalThe ID of an existing section in the project before which the updated section should be inserted. Cannot be provided with section_insert_after_id.
section_namestringOptionalThe new name for the section. It cannot be an empty string.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'updateSection'.
#

AsanaApi.UpdateTask

Update specific fields of an existing Asana task. Allows updating of specific fields in a task on Asana using the task's unique ID. Only the specified fields are altered, preventing unintended overwrite of other data. Requires 'tasks:write' scope. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires path, query parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required path, query parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
task_idstringOptionalThe unique identifier of the task to update in Asana. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
include_optional_propertiesarray<string>OptionalComma-separated list of task properties to include in the response, such as 'created_at', 'due_date', etc. Only used when mode is 'execute'.
pretty_output_enabledbooleanOptionalSet to true for a formatted response with line breaks and indentation. Useful for debugging. Only used when mode is 'execute'.
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'updateTask'.
#

AsanaApi.UpdateTaskParentAsana

Update the parent of an Asana task. This tool updates the parent of a given task in Asana, allowing it to become a subtask of another task or to remove its existing parent. Utilize `insert_before` or `insert_after` to position subtasks appropriately, ensuring they are already part of the parent task. Requires 'tasks:write' scope.

Parameters

ParameterTypeReq.Description
task_identifierstringRequiredThe unique identifier of the task to operate on. It should be a string.
enable_pretty_outputbooleanOptionalSet this to true to receive formatted output with line breaks and indentation. This is useful for debugging but increases response size and time.
include_optional_propertiesarray<string>OptionalA list of optional task properties to include in the response. Use a list of property names.
new_task_parentstringOptionalThe new parent task ID for the task, or null to remove its current parent.
subtask_to_insert_afterstringOptionalSpecify the subtask ID to insert the task after, or use 'null' to insert at the beginning of the list.
subtask_to_insert_beforestringOptionalSpecify a subtask ID to insert the task before, or null to place at the end of the list.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'setParentForTask'.
#

AsanaApi.UpdateTeamInWorkspace

Update a team within the current workspace. Use this tool to modify the details of a team in Asana's workspace. It should be called when you need to update team settings or information. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires path, query parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required path, query parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Parameters

ParameterTypeReq.Description
modestringRequiredOperation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operation
get_request_schemaexecute
team_global_idstringOptionalGlobally unique identifier for the team to update in the workspace. Required to specify which team will be modified. Required when mode is 'execute', ignored when mode is 'get_request_schema'.
include_optional_propertiesarray<string>OptionalList of optional properties to include in the response. Use a list format for specifying multiple properties. Only used when mode is 'execute'.
enable_pretty_outputbooleanOptionalEnable 'pretty' formatted output for easier readability in responses, increasing response size and time, mainly used for debugging. Only used when mode is 'execute'.
request_bodystringOptionalStringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema'

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'updateTeam'.
#

AsanaApi.UpdateTimeTrackingEntry

Updates an existing time tracking entry in Asana. Use this tool to update specific fields of an existing time tracking entry in Asana by specifying only the fields you wish to change. It helps avoid overwriting changes made by others and returns the updated record.

Parameters

ParameterTypeReq.Description
time_tracking_entry_idstringRequiredGlobally unique identifier for the time tracking entry to be updated.
duration_minutes_trackedintegerOptionalThe time in minutes tracked by the entry. Optional field.
enable_pretty_outputbooleanOptionalEnable formatted output for easier readability. Use mainly for debugging as it increases response time and size.
entry_logged_datestringOptionalThe date the entry is logged. Defaults to today if not specified. Use format 'YYYY-MM-DD'.
include_optional_propertiesarray<string>OptionalComma-separated list of optional properties to include in the response.
project_attributable_gidstringOptionalOptional. The globally unique identifier (gid) of the project to which the time is attributable.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'updateTimeTrackingEntry'.
#

AsanaApi.UpdateWorkspaceName

Update the name of an existing Asana workspace. Use this tool to change the name of a specific, existing Asana workspace. Only the workspace name can be modified, and the tool will return the complete, updated workspace record.

Parameters

ParameterTypeReq.Description
workspace_global_idstringRequiredGlobally unique identifier for the workspace or organization.
enable_pretty_outputbooleanOptionalEnable this to receive the response in a readable and formatted style. Useful for debugging. May increase response size and time.
include_optional_fieldsarray<string>OptionalList of additional workspace properties to include in the response, comma-separated.
resource_base_typestringOptionalSpecify the base type of the resource to update the workspace name.
workspace_namestringOptionalThe new name for the Asana workspace you want to update.
workspace_resource_gidstringOptionalGlobally unique identifier of the workspace resource. This is required to specify which workspace to update.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'updateWorkspace'.
#

AsanaApi.WorkspaceTypeaheadSearch

Retrieve workspace objects using a typeahead search. This tool fetches objects within a workspace via a typeahead search, providing quick, but not exhaustive or highly accurate results. It's useful for implementing auto-completion features by obtaining a compact representation of workspace objects, such as user, project, task, or project_template, ordered by relevance criteria specific to each type.

Parameters

ParameterTypeReq.Description
workspace_idstringRequiredGlobally unique identifier for the workspace or organization.
enable_pretty_outputbooleanOptionalEnable pretty format for the response with proper indentation. Use for debugging due to increased response size, but not recommended for production.
include_optional_fieldsarray<string>OptionalA list of properties to include in the response, set as a comma-separated list to include optional fields in the result.
resource_typestringOptionalSpecify the type of workspace objects to return, such as 'custom_field', 'portfolio', 'project', 'tag', 'task', or 'user'.
results_countintegerOptionalThe number of results to return, ranging from 1 to 100. Default is 20.
search_querystringOptionalString to search for relevant workspace objects. An empty string will return results.
search_result_resource_typestringOptionalSpecify the type of objects to return in the typeahead search. Options: custom_field, goal, project, project_template, portfolio, tag, task, team, user. Only one type can be used at a time.

Requirements

No secrets required

Output

Type:jsonResponse from the API endpoint 'typeaheadForWorkspace'.
Last updated on