Asana API
Tools that enable LLMs to interact directly with the Asana API.
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)
| Tool name | Description | Secrets | |
|---|---|---|---|
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.
|
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
| Parameter | Type | Req. | Description |
|---|---|---|---|
mode | string | Required | Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operationget_request_schemaexecute |
include_optional_fields | array<string> | Optional | Comma-separated list of optional task properties to include in the response. Excludes some properties by default. Only used when mode is 'execute'. |
enable_pretty_output | boolean | Optional | Enable 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_body | string | Optional | Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema' |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
mode | string | Required | Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operationget_request_schemaexecute |
project_global_id | string | Optional | Globally unique identifier for the project in Asana. Required when mode is 'execute', ignored when mode is 'get_request_schema'. |
include_optional_properties | array<string> | Optional | Comma-separated list of properties to include in the response, typically those excluded by default. Only used when mode is 'execute'. |
enable_pretty_output | boolean | Optional | Set 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_body | string | Optional | Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema' |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
mode | string | Required | Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operationget_request_schemaexecute |
portfolio_identifier | string | Optional | Globally 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_enabled | boolean | Optional | Set to true to format the response for better readability, useful for debugging. Only used when mode is 'execute'. |
request_body | string | Optional | Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema' |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
target_task_id | string | Required | The unique identifier for the task to add dependents to. |
dependent_task_gids | array<string> | Optional | An array of task GIDs to be marked as dependents for this task. |
enable_pretty_output | boolean | Optional | Set to true to format the response for readability. Use during debugging, as it increases response time and size. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
mode | string | Required | Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operationget_request_schemaexecute |
custom_field_identifier | string | Optional | Globally 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_properties | array<string> | Optional | List 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_output | boolean | Optional | Enable 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_body | string | Optional | Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema' |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
goal_unique_id | string | Required | Globally unique identifier for the goal to which you want to add followers. |
enable_pretty_output | boolean | Optional | Set 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_include | array<string> | Optional | Comma-separated list of optional properties to include in the response for additional details. |
user_identifiers_array | array<string> | Optional | An array of user identifiers to add as followers. These can be 'me', emails, or user gids. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
project_unique_id | string | Required | Globally unique identifier for the project to which followers will be added. |
enable_pretty_output | boolean | Optional | Enable pretty JSON output for readability, useful for debugging. May slow responses. |
optional_fields_to_include | array<string> | Optional | Comma-separated list of optional properties to include in the response to enrich data output. |
user_identifiers_to_add_as_followers | string | Optional | An array of user identifiers to add as followers. Accepts 'me', email addresses, or user gids. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
task_gid | string | Required | The unique identifier of the task to add followers to. This is required to specify which task the followers should be added to. |
enable_pretty_output | boolean | Optional | Enables pretty formatting for the response, adding line breaks and indentation. Useful for debugging but increases response size. |
followers_identification | array<string> | Optional | An array of strings identifying users, which can be 'me', an email, or a user gid. |
include_optional_properties | array<string> | Optional | Comma-separated list of optional task properties to include in the response. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
portfolio_unique_id | string | Required | Globally unique identifier for the portfolio to which the item will be added. |
add_after_item_id | string | Optional | ID of an item in the portfolio where the new item will be added after. Cannot be used with 'add_before_item_id'. |
enable_pretty_output | boolean | Optional | Enable pretty JSON formatting for debugging. This increases response size and processing time. |
insert_item_before_id | string | Optional | ID 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_portfolio | string | Optional | The ID of the item to be added to the Asana portfolio. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
project_unique_identifier | string | Required | Globally unique identifier for the project in Asana. |
include_optional_properties | array<string> | Optional | A comma-separated list of optional properties to include in the response. This adds excluded properties by default. |
pretty_output | boolean | Optional | If true, the response is formatted with line breaks and indentation for readability. Use mainly for debugging. |
user_identifiers_array | string | Optional | An array of strings identifying users to be added to the project. Values can be 'me', an email, or a user GID. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
portfolio_global_id | string | Required | Globally unique identifier for the portfolio to which members will be added. |
enable_pretty_output | boolean | Optional | Set to true for readable line-breaking and indentation in the response. Use for debugging as it increases response size and time. |
include_optional_properties | array<string> | Optional | A list of optional properties to include in the response, provided as an array of strings. |
portfolio_member_identifiers | string | Optional | An array of strings identifying users to add. Use 'me', an email, or user gid. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
task_id | string | Required | The unique identifier of the task to which the tag should be added. |
enable_pretty_output | boolean | Optional | Enable this to receive a prettified JSON response. Useful for debugging, but increases response time and size. |
tag_gid_to_add | string | Optional | The GID of the tag to be added to the specified task. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
mode | string | Required | Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operationget_request_schemaexecute |
target_task_id | string | Optional | The 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_properties | array<string> | Optional | Comma-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_output | boolean | Optional | Formats 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_body | string | Optional | Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema' |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
task_id_to_modify | string | Required | The unique identifier of the task to which dependencies will be added. |
enable_pretty_output | boolean | Optional | Enable pretty formatting for the response output. Provides improved readability with line breaking and indentation, recommended for debugging only. |
task_dependency_ids | array<string> | Optional | An array of task GIDs that the current task depends on. These are required to establish dependencies between tasks in Asana. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
task_global_id | string | Required | The unique global ID of the task to be operated on. |
enable_pretty_output | boolean | Optional | Set to true for formatted JSON output, making it more readable. Useful for debugging. Note: This increases response time and size. |
insert_after_task_id | string | Optional | Provide the ID of a task in the project to insert this task after, or use 'null' to insert at the beginning. |
insert_task_before | string | Optional | Specify 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_task | string | Optional | The unique identifier of the project to which the task will be added. |
target_section_id | string | Optional | The ID of the section in the project to insert the task at the bottom. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
section_global_identifier | string | Required | The globally unique identifier for the section where the task will be added. |
enable_pretty_output | boolean | Optional | Enable pretty formatting for the API response, with line breaks and indentation for readability. Use mainly for debugging. |
insert_after_task_id | string | Optional | Specify the task ID after which the new task should be inserted within the section. Cannot be used with insert_before. |
insert_task_before | string | Optional | The ID of an existing task in the section to insert the new task before. Cannot be used with insert_task_after. |
task_description | string | Optional | The name or description of the task to be added to the specified section. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
team_unique_identifier | string | Required | Globally unique identifier for the team to which the user is being added. |
enable_pretty_output | boolean | Optional | Set 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_properties | array<string> | Optional | Comma-separated list of properties to include in the response, which are excluded by default. |
user_identifier | string | Optional | Identifies the user to add. Use "me", an email, or the user's global ID (gid). |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
workspace_global_identifier | string | Required | Globally unique identifier for the workspace or organization in Asana. |
enable_pretty_output | boolean | Optional | Enable 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_fields | array<string> | Optional | Comma-separated list of optional properties to include in the response. |
user_identifier | string | Optional | A string identifying a user. Can be "me", an email, or a user ID (gid). |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
access_request_global_id | string | Required | Globally unique identifier for the specific access request to approve. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
mode | string | Required | Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operationget_request_schemaexecute |
include_optional_properties | array<string> | Optional | Comma-separated list of optional properties to include in the response, enhancing the returned team's details. Only used when mode is 'execute'. |
pretty_output_enabled | boolean | Optional | Set to true to receive pretty, human-readable output with line breaks and indentation. Use for debugging. Only used when mode is 'execute'. |
request_body | string | Optional | Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema' |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
project_global_id | string | Required | Globally unique identifier for the project to be duplicated. |
include_elements_in_project_duplication | string | Optional | A comma-separated list of optional elements to include when duplicating a project. Some elements are auto-included and cannot be excluded. |
include_optional_fields | array<string> | Optional | Comma-separated list of optional properties to include in the response, such as additional project details. |
last_due_date_in_duplicated_project | string | Optional | Sets the last due date in the duplicated project. The subsequent due dates will be offset similarly to the original project. |
new_project_name | string | Optional | The name for the duplicated project in Asana. |
new_project_team_id | string | Optional | Globally 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_enabled | boolean | Optional | Enable pretty formatting for the response output. Useful for debugging but increases response size and time. |
skip_weekends_in_schedule | boolean | Optional | Set to true to skip weekends for auto-shifted dates in the duplicated project schedule. This is a required parameter. |
start_date_for_first_task | string | Optional | Sets the first start date in the duplicated project. Adjusts other start dates based on this. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
task_id | string | Required | The unique identifier of the task from which followers are to be removed. |
enable_pretty_output | boolean | Optional | Set to true for readable JSON with line breaks and indentation. Use for debugging; increases response size and processing time. |
followers_to_remove | array<string> | Optional | An array of strings identifying users to remove as followers. Acceptable formats: "me", an email, or a user's gid. |
include_optional_properties | array<string> | Optional | A list of optional task properties to include in the response. Specify as an array of strings. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
mode | string | Required | Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operationget_request_schemaexecute |
webhook_global_id | string | Optional | Globally unique identifier for the webhook to update its filters. Required when mode is 'execute', ignored when mode is 'get_request_schema'. |
include_optional_properties | array<string> | Optional | Comma-separated list of optional properties to include in the response. Only used when mode is 'execute'. |
enable_pretty_output | boolean | Optional | Enable 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_body | string | Optional | Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema' |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
mode | string | Required | Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operationget_request_schemaexecute |
optional_properties_to_include | array<string> | Optional | List 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_output | boolean | Optional | Enable 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_body | string | Optional | Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema' |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
mode | string | Required | Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operationget_request_schemaexecute |
include_optional_properties | array<string> | Optional | Comma-separated list of optional properties to include in the response for a more comprehensive goal record. Only used when mode is 'execute'. |
enable_pretty_output | boolean | Optional | Enables pretty formatting for the API response, useful for debugging. Increases response time and size. Only used when mode is 'execute'. |
request_body | string | Optional | Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema' |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
mode | string | Required | Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operationget_request_schemaexecute |
enable_pretty_output | boolean | Optional | If 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_body | string | Optional | Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema' |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
mode | string | Required | Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operationget_request_schemaexecute |
include_optional_fields | array<string> | Optional | List the optional properties to include in the response, such as ['name', 'members']. Only used when mode is 'execute'. |
enable_pretty_output | boolean | Optional | If 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_body | string | Optional | Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema' |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
mode | string | Required | Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operationget_request_schemaexecute |
team_global_id | string | Optional | Globally unique identifier for the team in Asana. Required when mode is 'execute', ignored when mode is 'get_request_schema'. |
include_optional_project_properties | array<string> | Optional | Specify properties to include as a comma-separated list to get additional project details. Only used when mode is 'execute'. |
enable_pretty_output | boolean | Optional | Set 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_body | string | Optional | Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema' |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
task_template_id | string | Required | Globally unique identifier for the task template used to create the task. |
enable_pretty_output | boolean | Optional | Enable 'pretty' formatting of the response for better readability. Useful for debugging but may increase response time and size. |
include_optional_properties | array<string> | Optional | List of optional properties to include in the task resource, comma-separated. |
task_name | string | Optional | The name of the new task to be created. If not provided, the task template name will be used by default. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
mode | string | Required | Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operationget_request_schemaexecute |
include_optional_properties | array<string> | Optional | Specify 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_output | boolean | Optional | If 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_body | string | Optional | Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema' |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
mode | string | Required | Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operationget_request_schemaexecute |
include_optional_properties | array<string> | Optional | A 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_output | boolean | Optional | Set 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_body | string | Optional | Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema' |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
mode | string | Required | Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operationget_request_schemaexecute |
goal_global_id | string | Optional | Globally 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_properties | array<string> | Optional | Specify the optional properties to include in the response as a list of strings. Only used when mode is 'execute'. |
enable_pretty_output | boolean | Optional | Set 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_body | string | Optional | Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema' |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
goal_global_identifier | string | Required | Globally unique identifier for the goal to which a supporting resource will be added. |
enable_pretty_output | boolean | Optional | Enable 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_fields | array<string> | Optional | Comma-separated list of optional resource properties to include in the response. |
insert_after_subgoal_id | string | Optional | ID of the subgoal to insert the new subgoal after. Cannot use with `insert_before`. Only for subgoal addition. |
insert_subgoal_before_id | string | Optional | The 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_weight | integer | Optional | A number between 0 and 1 indicating the supporting goal's contribution to the parent goal's progress. Defaults to 0. |
supporting_resource_id | string | Optional | The GID of the supporting resource to add to the parent goal. It must be the GID of a goal, project, task, or portfolio. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
mode | string | Required | Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operationget_request_schemaexecute |
included_properties_list | array<string> | Optional | List 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_output | boolean | Optional | Set 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_body | string | Optional | Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema' |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
mode | string | Required | Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operationget_request_schemaexecute |
include_optional_properties | array<string> | Optional | Specify 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_enabled | boolean | Optional | Set 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_body | string | Optional | Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema' |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
mode | string | Required | Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operationget_request_schemaexecute |
include_optional_fields | array<string> | Optional | A list of optional properties to include in the response. Provide as an array of strings. Only used when mode is 'execute'. |
enable_pretty_output | boolean | Optional | Enable 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_body | string | Optional | Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema' |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
mode | string | Required | Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operationget_request_schemaexecute |
project_global_id | string | Optional | Globally 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_properties | array<string> | Optional | List 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_output | boolean | Optional | Set to true to format the response with line breaks and indentation for readability. Useful for debugging. Only used when mode is 'execute'. |
request_body | string | Optional | Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema' |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
mode | string | Required | Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operationget_request_schemaexecute |
workspace_identifier | string | Optional | Globally 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_properties | array<string> | Optional | Comma-separated list of optional properties to include in the response. Only used when mode is 'execute'. |
pretty_output | boolean | Optional | Set to true for formatted, readable output. Use mainly during debugging as it increases response time and size. Only used when mode is 'execute'. |
request_body | string | Optional | Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema' |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
mode | string | Required | Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operationget_request_schemaexecute |
project_global_id | string | Optional | Globally unique identifier for the project in Asana. Required when mode is 'execute', ignored when mode is 'get_request_schema'. |
included_optional_properties | array<string> | Optional | Comma-separated list of optional properties to include in the response, which are excluded by default. Only used when mode is 'execute'. |
enable_pretty_output | boolean | Optional | If true, format the response for readability with line breaks and indentation. Mainly for debugging purposes. Only used when mode is 'execute'. |
request_body | string | Optional | Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema' |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
project_global_id | string | Required | Globally unique identifier for the project. Required to specify which project is being saved as a template. |
enable_pretty_output | boolean | Optional | Enable pretty output formatting for easier readability in the response. Use mainly for debugging as it may increase response time and size. |
include_optional_properties | array<string> | Optional | Specify a list of optional properties to include in the response by listing their names as strings. |
make_template_public | boolean | Optional | Specify true to make the project template public to its team. Use false to keep it private. |
team_id_for_project_template | string | Optional | Specify the team ID for the new project template. Use this when the project is in an organization. |
template_name | string | Optional | The name of the new project template in Asana. |
workspace_id_for_project_template | string | Optional | Globally unique identifier for the workspace of the new project template. Use only if the project is in a workspace. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
project_global_id | string | Required | Globally unique identifier for the project in which to create the section. |
enable_pretty_output | boolean | Optional | Set to true for a readable response format with line breaks and indentation. Use for debugging only. |
include_optional_properties | array<string> | Optional | Comma-separated list of optional properties to include in the response. |
insert_after_section_id | string | Optional | ID of an existing section to insert the new section after. Cannot be used with insert_before_section_id. |
insert_before_section_id | string | Optional | ID of an existing section in the project before which the new section will be inserted. Cannot be used with 'insert_after_section_id'. |
section_name | string | Optional | The name to display as the section title in the project. This cannot be empty. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
mode | string | Required | Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operationget_request_schemaexecute |
results_per_page | integer | Optional | Number of status updates to return per page, between 1 and 100. Only used when mode is 'execute'. |
pagination_offset_token | string | Optional | Token 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_fields | array<string> | Optional | List 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_output | boolean | Optional | Set 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_body | string | Optional | Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema' |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
mode | string | Required | Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operationget_request_schemaexecute |
parent_task_id | string | Optional | The 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_fields | array<string> | Optional | Comma-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_output | boolean | Optional | Set 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_body | string | Optional | Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema' |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
task_id | string | Required | The unique identifier for the task to operate on. |
duration_minutes_tracked | integer | Optional | Time in minutes tracked by the entry. Must be greater than 0. |
enable_pretty_output | boolean | Optional | Set to true to receive formatted, human-readable JSON responses. Useful for debugging as it may slow down the response. |
entry_logged_date | string | Optional | Optional. The date the time entry is logged. Defaults to today if not specified. |
include_optional_properties | array<string> | Optional | A 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_attribution | string | Optional | Optional. The GID of the project to which the tracked time is attributed. If not provided, no project attribution is made. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
mode | string | Required | Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operationget_request_schemaexecute |
workspace_id | string | Optional | Globally unique identifier for the workspace or organization in Asana. Required when mode is 'execute', ignored when mode is 'get_request_schema'. |
included_optional_properties | array<string> | Optional | List of optional properties to include in the response, specified as an array of strings. Only used when mode is 'execute'. |
enable_pretty_output | boolean | Optional | Enable pretty JSON formatting for improved readability. Use mainly during debugging as it may increase response size. Only used when mode is 'execute'. |
request_body | string | Optional | Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema' |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
allocation_id | string | Required | Globally unique identifier for the allocation to be deleted. |
pretty_formatting | boolean | Optional | Provide pretty JSON formatting for better readability, recommended for debugging. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
goal_identifier | string | Required | The unique global identifier for the specific Asana goal to delete. |
enable_pretty_output | boolean | Optional | If true, provides pretty JSON output with indentation and line breaks for readability. Recommended for debugging due to increased response size and time. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
membership_id | string | Required | Globally unique identifier for the membership to be deleted. |
pretty_output_enabled | boolean | Optional | Enable pretty-printed JSON format for a more readable response. Recommended for debugging, as it increases response time and size. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
project_unique_identifier | string | Required | Globally unique identifier for the project to be deleted in Asana. |
enable_pretty_output | boolean | Optional | Enable 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
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
section_global_identifier | string | Required | The globally unique identifier for the section to be deleted in Asana. |
enable_pretty_output | boolean | Optional | If true, returns JSON with line breaks and indentation for readability. Increases response time and size, suitable for debugging. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
story_unique_id | string | Required | Globally unique identifier for the story to be deleted. |
enable_pretty_output | boolean | Optional | Enable this for a readable, formatted response. Useful for debugging, but increases response time. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
tag_unique_identifier | string | Required | The globally unique identifier for the Asana tag to be deleted. |
enable_pretty_output | boolean | Optional | Set to true for formatted JSON output with line breaks and indentation. Use mainly for debugging as it increases response size. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
task_identifier | string | Required | The unique identifier of the task to delete in Asana. |
pretty_output_enabled | boolean | Optional | Set to true for 'pretty' formatted response, useful for debugging. May increase response size and time. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
webhook_global_id | string | Required | Globally unique identifier for the specific webhook to delete in Asana. |
enable_pretty_output | boolean | Optional | If true, formats the response with line breaks and indentation for readability. Use primarily for debugging as it increases response time and size. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
attachment_unique_id | string | Required | Globally unique identifier for the attachment to be deleted. |
pretty_output_enabled | boolean | Optional | Set 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
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
custom_field_id | string | Required | The unique global identifier for the custom field to be deleted. |
pretty_output | boolean | Optional | Set to true for a formatted and indented response; mainly for debugging. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
portfolio_global_id | string | Required | Globally unique identifier for the portfolio to be deleted. |
enable_pretty_output | boolean | Optional | Enable this to receive a 'pretty' formatted JSON response, advisable for debugging only as it increases response time and size. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
project_brief_unique_id | string | Required | Globally unique identifier for the project brief to be deleted. |
enable_pretty_output | boolean | Optional | Set to true for pretty-formatted output, making it more readable. Useful for debugging, this may increase response time and size. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
project_status_id | string | Required | The identifier for the project status update you wish to delete. |
pretty_output | boolean | Optional | Enable pretty output for readable formatting during debugging; increases response size and time. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
project_template_identifier | string | Required | Globally unique identifier for the Asana project template to delete. |
enable_pretty_output | boolean | Optional | If true, outputs the response in a readable, pretty format with line breaks and indentation, mainly for debugging purposes. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
status_update_id | string | Required | Unique ID of the status update to be deleted. |
pretty_output | boolean | Optional | If true, the response is formatted for readability with line breaks and indentation. This increases response size and time, so use for debugging. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
task_template_id | string | Required | Globally unique identifier for the task template to be deleted. |
enable_pretty_output | boolean | Optional | Set to True for a pretty, formatted JSON response. This is useful for debugging but may increase response time and size. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
time_tracking_entry_identifier | string | Required | Globally unique identifier for the time tracking entry to be deleted. |
enable_pretty_output | boolean | Optional | Set to true for a formatted, readable JSON response. Use for debugging; increases response time and size. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
task_gid | string | Required | The unique identifier of the task to duplicate in Asana. |
enable_pretty_output | boolean | Optional | Enable pretty printing of the JSON response for improved readability. Use this primarily for debugging as it increases response size and time. |
fields_to_duplicate | string | Optional | Comma-separated list of task fields to duplicate, such as assignee, attachments, dates, etc. |
new_task_name | string | Optional | The name for the newly duplicated task in Asana. |
optional_fields_to_include | array<string> | Optional | Comma-separated list of optional properties to include in the response. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
target_resource_id | string | Required | The ID of the resource to subscribe to. It can be a task, project, or goal. |
enable_pretty_output | boolean | Optional | Enable pretty JSON output with line breaks and indentation for readability; primarily for debugging. |
include_optional_properties | array<string> | Optional | Comma-separated list of property names to include in the response for more detailed event records. |
sync_token | string | Optional | A 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
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
attachment_unique_id | string | Required | The globally unique identifier for the attachment in Asana. |
enable_pretty_output | boolean | Optional | Set to true for pretty-printed JSON output. Increases response size and time; recommended for debugging. |
include_optional_properties | array<string> | Optional | An array of properties to include in the response. Specify which additional fields you want in the returned attachment record. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
job_id | string | Required | Globally unique identifier for the job to fetch details for. |
include_optional_properties | array<string> | Optional | Comma-separated list of optional properties to include in the response for the job. |
opt_pretty | boolean | Optional | Set to true for pretty output with line breaks and indentation. Use this for debugging as it increases response time and size. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
enable_pretty_output | boolean | Optional | Enable this to receive the response in a readable format with proper indentation. Useful for debugging, but increases response time and size. |
optional_fields_to_include | array<string> | Optional | A list of property names to include in the response. Specify the properties you wish to see for the task templates. |
pagination_offset_token | string | Optional | Offset token for pagination, returned by the API. Use to request the next page of results. |
project_id | string | Optional | The unique identifier for the project to filter task templates. |
results_per_page | integer | Optional | Number of task templates to return per page, between 1 and 100. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
emoji_base_character | string | Required | Specify the emoji base character to filter reactions. Returns only reactions with this emoji. |
object_gid | string | Required | Globally unique identifier (GID) for the Asana object (status update or story) from which to fetch reactions. |
enable_pretty_output | boolean | Optional | Enable for readable JSON output with line breaks and indentation. Use primarily for debugging due to increased response size and time. |
pagination_offset_token | string | Optional | Offset 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_page | integer | Optional | Specify the number of results to return per page. Must be between 1 and 100. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
status_update_id | string | Required | Unique identifier for the status update to retrieve the complete record. |
enable_pretty_output | boolean | Optional | Set to true for a readable, pretty format with indentation. Useful for debugging. |
include_optional_fields | array<string> | Optional | A list of optional fields to include in the response. Provide the fields as a list of strings. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
task_template_unique_id | string | Required | Globally unique identifier for the task template to retrieve its complete record. |
enable_pretty_output | boolean | Optional | Enable pretty formatting for the output, making it more readable with line breaking and indentation. Use mainly for debugging. |
include_optional_fields | array<string> | Optional | Specify properties to include in the response. Provide as a list of strings. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
team_global_identifier | string | Required | Globally unique identifier for the team to retrieve memberships for. |
enable_pretty_output | boolean | Optional | Boolean to enable pretty formatted output with line breaks and indentation. Recommended for debugging due to increased response size and time. |
optional_properties_to_include | array<string> | Optional | A 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_token | string | Optional | Token to retrieve the next page of results. Use the offset provided in a previous response for pagination. |
results_per_page | integer | Optional | Number of objects to return per page. Must be between 1 and 100. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
enable_pretty_output | boolean | Optional | Enable pretty formatting for the response. Useful for debugging, but increases response time and size. |
include_optional_fields | array<string> | Optional | Include optional properties in the response by listing field names as a comma-separated array. This enhances the response data detail. |
pagination_offset_token | string | Optional | Token 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_id | string | Optional | Globally unique identifier for the portfolio to filter time tracking entries by. |
project_identifier_attribution | string | Optional | Unique ID for the project to filter time tracking entries by attribution. |
results_per_page | integer | Optional | Specify the number of time tracking entries to return per page. Acceptable values are between 1 and 100. |
task_id | string | Optional | Globally 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_filter | string | Optional | Globally unique identifier for the user to filter time tracking entries by. |
workspace_identifier | string | Optional | Globally unique identifier for the Asana workspace to filter the time tracking entries. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
user_task_list_global_id | string | Required | Globally unique identifier for the user task list in Asana. |
enable_pretty_output | boolean | Optional | Set to true for readable, indented JSON output. Use primarily for debugging due to increased response size. |
include_optional_properties | array<string> | Optional | Specify which optional properties should be included in the response. Provide as a list of strings. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
user_identifier | string | Required | A string to identify the user, either "me", an email, or the user's gid. |
workspace_id | string | Required | The ID of the workspace to retrieve the user's task list from in Asana. |
enable_pretty_output | boolean | Optional | Enable 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_properties | array<string> | Optional | A list of optional properties to include in the response, specified as an array of strings. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
allocation_unique_id | string | Required | Globally unique identifier for the allocation to fetch the complete record. |
enable_pretty_output | boolean | Optional | Set to true to receive the response in a pretty, readable format. Useful for debugging, but increases response size and time. |
include_optional_properties | array<string> | Optional | Comma-separated list of optional properties to include in the response, as some properties are excluded by default. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
goal_global_identifier | string | Required | Globally unique identifier for the goal to be retrieved. |
enable_pretty_output | boolean | Optional | If true, formats the response with line breaks and indentation for readability, increasing response size and time. |
include_optional_fields | array<string> | Optional | Specify optional properties to include in the response as a list of strings. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
enable_pretty_output | boolean | Optional | Enable pretty JSON formatting for debugging. Increases response size and processing time. |
optional_fields_to_include | array<string> | Optional | Comma-separated list of optional properties to include in the response. |
pagination_offset_token | string | Optional | The 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_page | integer | Optional | Number of projects to return per page, from 1 to 100. |
return_only_archived_projects | boolean | Optional | Boolean to filter projects by their archived status. Setting this to true returns only archived projects. |
team_filter | string | Optional | Specify the team to filter projects in the Asana workspace. |
workspace_filter | string | Optional | Specify the workspace or organization to filter the Asana projects. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
include_optional_fields | array<string> | Optional | A list of optional properties to include in the response. Provide as an array of strings, with each string representing a property name. |
pagination_offset_token | string | Optional | Offset 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_output | boolean | Optional | Set to true to enable pretty JSON formatting for debugging, despite increased size and time. |
results_per_page | integer | Optional | Specify the number of project templates to return per page, between 1 and 100. |
team_filter | string | Optional | The team ID to filter project templates on. |
workspace_identifier | string | Optional | The identifier of the workspace to filter project templates results on. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
section_global_id | string | Required | The globally unique identifier for the section to retrieve. |
enable_pretty_output | boolean | Optional | Set 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_properties | array<string> | Optional | Specify a list of optional properties to include in the response. This should be an array of strings. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
story_identifier | string | Required | Globally unique identifier for the Asana story to be retrieved. |
enable_pretty_output | boolean | Optional | Set 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_properties | array<string> | Optional | A list of optional properties to include in the story record, specified as an array of strings. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
tag_global_identifier | string | Required | Globally unique identifier for the tag in Asana used to fetch the complete tag details. |
enable_pretty_output | boolean | Optional | Enable to format the response in a readable, pretty format. Increases response size and time; useful for debugging. |
include_optional_fields | array<string> | Optional | Comma-separated list of additional tag properties to include in the response. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
team_global_id | string | Required | Globally unique identifier for the specific Asana team to retrieve details for. |
enable_pretty_output | boolean | Optional | Set to true for human-readable formatting, with line breaks and indentation. Increases response time and size; use for debugging. |
include_optional_fields | array<string> | Optional | Comma-separated list of optional properties to include in the response. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
filter_by_organization | string | Required | Specify the workspace or organization to filter the teams on for the Asana user. |
user_identifier | string | Required | A string identifying a user. Accepts 'me', an email, or user's gid. |
enable_pretty_output | boolean | Optional | Set to true to format the response with line breaks and indentation. Useful for debugging but can increase response size. |
include_optional_fields | array<string> | Optional | Comma-separated list of optional properties to include in the response. |
pagination_offset_token | string | Optional | Offset 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_page | integer | Optional | Number of team records to return per page. Must be between 1 and 100. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
workspace_global_id | string | Required | Globally unique identifier for the workspace or organization in Asana. |
enable_pretty_output | boolean | Optional | Set 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_fields | array<string> | Optional | Comma-separated list of optional properties to include in the response. |
pagination_offset_token | string | Optional | An 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_page | integer | Optional | Number of teams to return per page, between 1 and 100. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
enable_pretty_output | boolean | Optional | Enable pretty formatting of the response for easier readability. Recommended for debugging as it increases response size and time. |
filter_by_team_id | string | Optional | The team ID to filter users in Asana. It allows you to specify a particular team to narrow down the user results. |
include_optional_properties | array<string> | Optional | Comma-separated list of optional user properties to include in the response. Use this to fetch additional fields excluded by default. |
pagination_offset_token | string | Optional | Offset token for pagination, used to fetch subsequent pages of results. Only valid when using an offset returned in a prior request. |
results_per_page | integer | Optional | The number of user records to return per page. Must be between 1 and 100. |
workspace_id | string | Optional | The ID of the workspace or organization to filter users on. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
workspace_id | string | Required | The unique identifier of the Asana workspace to query for webhooks. |
enable_pretty_output | boolean | Optional | Set to true for a readable, pretty-formatted JSON output. Increases response time and size. Use mainly for debugging. |
include_optional_properties | array<string> | Optional | Comma-separated list of properties to include in the response, which are excluded by default. |
pagination_offset_token | string | Optional | An offset token to retrieve the next page of results. Use the token from a previous API response for pagination. |
results_per_page | integer | Optional | Number of webhooks to return per page, between 1 and 100. |
specific_resource | string | Optional | Specify the resource ID to filter webhooks for that particular resource. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
object_gid | string | Required | Globally unique identifier for the Asana object to fetch attachments from, such as a `project`, `project_brief`, or `task`. |
enable_pretty_output | boolean | Optional | Return the response in a readable format with line breaks and indentation. Recommended for debugging as it may increase response size and time. |
include_optional_properties | array<string> | Optional | Comma-separated list of properties to include, which are excluded by default. |
pagination_offset_token | string | Optional | Token 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_page | integer | Optional | Number of objects to return per page, must be between 1 and 100. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
enable_pretty_output | boolean | Optional | Enable pretty formatting for readable JSON response. Mainly for debugging; increases response time and size. |
included_optional_properties | array<string> | Optional | A list of specific properties to include in the response. Use a comma-separated list format. |
is_workspace_level | boolean | Optional | Set to true to filter for goals where the workspace level is active. Must be used with the workspace parameter. |
pagination_offset_token | string | Optional | Offset token for pagination. Use the token from a previous response to retrieve the next page. If not provided, returns the first page. |
portfolio_id | string | Optional | Globally unique identifier for the supporting portfolio in Asana. |
project_id | string | Optional | Globally unique identifier for the project. Used to filter goals associated with a specific project. |
results_per_page | integer | Optional | The number of goal records to return per page. Must be between 1 and 100. |
supporting_task_id | string | Optional | Globally unique identifier for the supporting task in Asana. |
team_id | string | Optional | Globally unique identifier for the team. Use this to filter goals associated with a specific team. |
time_period_identifiers | array<string> | Optional | A list of globally unique identifiers for the desired time periods to filter the goals. |
workspace_id | string | Optional | Globally unique identifier for the workspace. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
custom_field_id | string | Required | Globally unique identifier for the custom field in Asana to retrieve its metadata. |
enable_pretty_output | boolean | Optional | Enable pretty printing for the output, making it more readable. Ideal for debugging, but increases response time and size. |
include_optional_properties | array<string> | Optional | Comma-separated list of optional properties to include in the response. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
project_id | string | Required | Globally unique identifier for the Asana project to retrieve custom field settings. |
enable_pretty_output | boolean | Optional | Enable to receive a pretty, human-readable response with line breaks and indentation. Increases response time and size, use for debugging. |
include_optional_fields | array<string> | Optional | Comma-separated list of property names to include in the response, expanding beyond the default fields. |
pagination_offset_token | string | Optional | An 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_page | integer | Optional | Specify the number of custom field settings to return per page, between 1 and 100. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
workspace_identifier | string | Required | Globally unique identifier for the workspace or organization in Asana. |
enable_pretty_output | boolean | Optional | Enable pretty printed output for the response, useful for debugging. This increases response time and size. |
include_optional_properties | array<string> | Optional | A list of properties to include in the response for a workspace's custom fields. Include values such as 'name', 'type', etc. |
pagination_offset_token | string | Optional | An 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_page | integer | Optional | Specifies the number of custom fields to return per page, between 1 and 100. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
custom_type_id | string | Required | Globally unique identifier for the custom type in Asana. |
enable_pretty_output | boolean | Optional | If 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_fields | array<string> | Optional | A list of property names to include in the response for the custom type. These are optional fields that are not included by default. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
project_id | string | Required | Globally unique identifier for the project to filter custom types. |
enable_pretty_output | boolean | Optional | Set to true for pretty-printed JSON output during debugging. Increases response size and time. |
include_optional_properties | array<string> | Optional | Comma-separated list of properties to include in the response for additional details. |
next_page_offset_token | string | Optional | Offset token from a previous response to fetch the next page of results. If not provided, the first page will be returned. |
results_per_page | integer | Optional | Number of custom types to return per page. Must be between 1 and 100. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
enable_pretty_output | boolean | Optional | Set to 'true' for pretty JSON output with line breaks and indentation. Use for readability during debugging. |
include_optional_properties | array<string> | Optional | A list of properties to include in the response, specified as strings. Use to retrieve fields not returned by default. |
pagination_offset | string | Optional | Offset token for pagination. Use the offset from the previous response to get the next page. If not provided, returns the first page. |
results_per_page | integer | Optional | Specifies how many tag records to return per page. Must be an integer between 1 and 100. |
workspace_for_filtering | string | Optional | The workspace ID used to filter tags in the request. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
assignee_id | string | Optional | The ID of the assignee to filter tasks on. If searching for unassigned tasks, use 'null'. Must be used with 'workspace'. |
completed_since_date_time | string | Optional | Tasks must be incomplete or completed since this date/time. Provide in ISO 8601 format (e.g., '2023-10-01T12:00:00Z'). |
enable_pretty_output | boolean | Optional | If true, provides the response in a pretty-printed, readable format. Use primarily for debugging as it increases response time and size. |
filter_by_project | string | Optional | Specify the project to filter tasks. Use a string identifier for the project. |
filter_by_workspace | string | Optional | The workspace to filter tasks by. Must be used with 'filter_by_assignee'. |
modified_since_time | string | Optional | Return tasks modified since this time. Include changes in properties or associations. Format as string (e.g., 'YYYY-MM-DDTHH:MM:SSZ'). |
optional_fields_to_include | array<string> | Optional | Specify properties to include in the response by providing an array of property names. These properties are excluded by default. |
pagination_offset | string | Optional | An offset token for pagination to retrieve the next page of results. Use a previously returned token to continue pagination. |
results_per_page | integer | Optional | Defines the number of task records to return per page. The value must be between 1 and 100. |
section_filter | string | Optional | The section to filter tasks within a project in Asana. Specify a section name to narrow down the tasks. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
goal_relationship_identifier | string | Required | Globally unique identifier for the goal relationship you want to retrieve. |
enable_pretty_output | boolean | Optional | Enables pretty formatting for the response, increasing readability but also response size and time. Use for debugging. |
include_optional_properties | array<string> | Optional | A comma-separated list of optional properties to include in the response. Use this to include properties that are not returned by default. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
supported_goal_id | string | Required | Globally unique identifier for the supported goal in the goal relationship. |
enable_pretty_output | boolean | Optional | Set to true for pretty JSON output with indentation. Use mainly for debugging as it increases response size and time. |
goal_relationship_resource_subtype | string | Optional | Filter goal relationships by a specific resource subtype. |
include_optional_properties | array<string> | Optional | Comma-separated list of optional properties to include in the response. Allows access to additional fields excluded by default. |
pagination_offset | string | Optional | Token to specify the starting point for the next page of results. Use the token from the previous response to continue pagination. |
results_per_page | integer | Optional | Specify the number of goal relationship records to return per page. Must be between 1 and 100. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
membership_id | string | Required | Globally unique identifier for the membership. Used to specify which membership record to retrieve. |
enable_pretty_output | boolean | Optional | Enable pretty output with indentation and line breaks for readability. Use for debugging as it increases response size and time. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
enable_pretty_output | boolean | Optional | Enable pretty JSON output with line breaks and indentation for readability. Use for debugging purposes as it may increase response time and size. |
include_optional_fields | array<string> | Optional | Comma-separated list of optional fields to include in the response. |
member_identifier | string | Optional | Globally unique identifier for a team or user to filter specific memberships. |
pagination_offset_token | string | Optional | Token for pagination. Use the offset from a previous API response to get the next page of results. |
parent_id | string | Optional | Globally unique identifier for a goal, project, portfolio, or custom field in Asana. |
results_per_page | integer | Optional | Specifies the number of objects to return per page. Must be between 1 and 100. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
organization_export_id | string | Required | Globally unique identifier for the organization export. Required to retrieve the export details. |
enable_pretty_output | boolean | Optional | Set to true for a human-readable response with line breaks and indentation. Recommended for debugging due to increased response size. |
include_optional_properties | array<string> | Optional | Optional 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
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
goal_unique_identifier | string | Required | Globally unique identifier for the Asana goal whose parent goals are to be fetched. |
include_optional_properties | array<string> | Optional | List of optional properties to include in the response. It should be a comma-separated list of strings. |
pretty_output_enabled | boolean | Optional | Set to true for a readable output format with line breaks and indentation, suitable for debugging. May increase response size and time. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
target_object_id | string | Required | Globally unique identifier for the target object in Asana. |
enable_pretty_output | boolean | Optional | Set to true for readable, indented output. Use primarily for debugging due to increased response size. |
filter_by_user | string | Optional | User identifier to filter requests. Accepts 'me', an email, or a user gid. |
include_optional_properties | array<string> | Optional | Comma-separated list of optional properties to include in the response. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
portfolio_unique_id | string | Required | Globally unique identifier for the portfolio in Asana. |
include_optional_fields | array<string> | Optional | List optional properties to include in the response, specified as an array of strings. |
pagination_offset_token | string | Optional | Offset 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_output | boolean | Optional | Set to true for pretty-formatted JSON output, with line breaks and indentation, mainly for debugging purposes. |
results_per_page | integer | Optional | Specify the number of results to return per page. Must be between 1 and 100. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
portfolio_unique_id | string | Required | Globally unique identifier for the specific portfolio to retrieve details. |
enable_pretty_output | boolean | Optional | Set to true for pretty, readable formatting of the output. Useful for debugging, but increases response size and time. |
include_optional_properties | array<string> | Optional | List 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
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
portfolio_unique_id | string | Required | Globally unique identifier for the portfolio. Required to fetch items for a specific portfolio. |
enable_pretty_output | boolean | Optional | If 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_properties | array<string> | Optional | Comma-separated list of optional properties to include in the response. |
pagination_offset_token | string | Optional | Token for offsetting to the next page of results. Use a token from previous pagination to retrieve subsequent pages. |
results_per_page | integer | Optional | The number of items to return per page, between 1 and 100. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
portfolio_membership_id | string | Required | The unique identifier for the portfolio membership to retrieve. |
enable_pretty_output | boolean | Optional | If true, enables pretty JSON output with line breaking and indentation, increasing response size and time. Useful for debugging. |
include_optional_properties | array<string> | Optional | A list of optional properties to include in the response, specified as strings. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
enable_pretty_output | boolean | Optional | Enable pretty output formatting with indentation for readability. Ideal for debugging, it increases response time and size. |
include_optional_fields | array<string> | Optional | A list of optional properties to include in the response. Provide them as an array of strings. |
pagination_offset_token | string | Optional | Token for pagination to retrieve the next page of results. Use the offset provided by a previous response. |
portfolio_filter | string | Optional | Specify the portfolio ID to filter the results. |
results_per_page | integer | Optional | Specifies the number of portfolio memberships to return per page, between 1 and 100. |
user_identifier | string | Optional | A string identifier for a user: "me", an email, or the user's gid. |
workspace_filter | string | Optional | Specify the workspace to filter portfolio membership results. This should match the workspace identifier used in Asana. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
assignee_id | string | Optional | Globally unique identifier for the user or placeholder the allocation is assigned to. |
enable_pretty_output | boolean | Optional | Enable pretty output format for JSON. Use this for easier reading during debugging, as it increases response size and processing time. |
include_optional_properties | array<string> | Optional | List properties to include in the response, provided as a list of strings. Provides access to additional data fields. |
pagination_offset | string | Optional | Offset 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_id | string | Optional | Globally unique identifier for the project to filter allocations by. |
results_per_page | integer | Optional | The number of allocations to return per page, between 1 and 100. |
workspace_id | string | Optional | Globally unique identifier for the workspace to filter allocations by. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
project_brief_identifier | string | Required | Globally unique identifier for the specific project brief to retrieve. |
include_optional_properties | array<string> | Optional | An array of property names to include in the response. These properties are excluded by default. |
pretty_output_enabled | boolean | Optional | Enable readable, formatted output. Suitable for debugging. Increases response time and size. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
project_global_identifier | string | Required | A unique identifier for the Asana project you want to retrieve details for. |
enable_pretty_output | boolean | Optional | Set to true for nicely formatted, readable output, mainly for debugging due to increased size and time. |
include_optional_properties | array<string> | Optional | A list of optional property names to include in the project details response. Provide these as a list of strings. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
project_membership_id | string | Required | The unique identifier for the project membership to retrieve details for. |
enable_pretty_output | boolean | Optional | Set to true for a human-readable response format, useful for debugging. |
include_optional_properties | array<string> | Optional | A list of optional project membership properties to include in the response. These are normally excluded by default. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
project_unique_identifier | string | Required | Globally unique identifier for the project to fetch memberships for. |
enable_pretty_output | boolean | Optional | Enable 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_properties | array<string> | Optional | List of properties to include in the response. Use a comma-separated list to specify optional properties to be included in the response. |
page_offset_token | string | Optional | Token for pagination to retrieve the next set of results. Use the token from a previous response to get subsequent pages. |
results_per_page | integer | Optional | The number of objects to return per page (between 1 and 100). |
user_identifier | string | Optional | A string identifying a user, either "me", an email, or the user's gid. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
project_unique_identifier | string | Required | Globally unique identifier for the project in Asana. |
enable_pretty_output | boolean | Optional | Enables readable formatting of the response when true, using line breaks and indentation. Recommended for debugging as it increases response time and size. |
included_optional_fields | array<string> | Optional | List 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_token | string | Optional | Offset 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_page | integer | Optional | Specify the number of sections to return per page, between 1 and 100. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
task_identifier | string | Required | The identifier of the task to retrieve associated projects for. |
enable_pretty_output | boolean | Optional | Set to true to receive the output in a 'pretty' format, useful for debugging. Note: This increases response time and size. |
optional_fields_to_include | array<string> | Optional | Comma-separated list of optional project properties to include in the response. |
pagination_offset | string | Optional | Offset token used for pagination. If not provided, the first page is returned. Only pass an offset returned from a previous request. |
results_per_page | integer | Optional | Number of project entries to return per page, between 1 and 100. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
project_status_update_id | string | Required | The ID of the project status update to retrieve. This should be a unique identifier for the specific status update. |
enable_pretty_output | boolean | Optional | If true, formats the response with line breaks and indentation for readability. Recommended for debugging only, as it increases response size. |
include_optional_properties | array<string> | Optional | A list of optional properties to include in the response. This allows fetching additional details that are excluded by default. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
project_global_identifier | string | Required | Globally unique identifier for the project in Asana. |
enable_pretty_output | boolean | Optional | Enable 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_fields | array<string> | Optional | Comma-separated list of optional properties to include in the response. |
pagination_offset_token | string | Optional | Offset token for pagination. Use the token provided by a previous request to retrieve the next page of results. |
results_per_page | integer | Optional | Number of status updates to return per page, must be between 1 and 100. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
project_global_id | string | Required | Globally unique identifier for the Asana project. Required to retrieve tasks from a specific project. |
completed_since | string | Optional | Return tasks incomplete or completed after this date-time or 'now'. |
enable_pretty_output | boolean | Optional | Enable pretty formatting for the response. This makes the output more readable but increases response size and time. Useful for debugging. |
include_optional_fields | array<string> | Optional | Comma-separated list of optional properties to include in the response. |
pagination_offset_token | string | Optional | Token for paginating results. Use it to retrieve the next set of tasks from a previously returned offset. |
results_per_page | integer | Optional | Number of task records to return per page in the result. Must be between 1 and 100. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
project_template_id | string | Required | Globally unique identifier for the project template to fetch complete details. |
include_optional_properties | array<string> | Optional | List properties to include in the response. Exclude default properties, using a comma-separated format. |
pretty_output_enabled | boolean | Optional | Set to true to receive a formatted and readable response output, suitable for debugging. Increases response time and size. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
team_id | string | Required | Globally unique identifier for the team to retrieve project templates. |
enable_pretty_output | boolean | Optional | Enable to get the response in a readable, "pretty" JSON format. Useful for debugging. |
include_optional_properties | array<string> | Optional | Comma-separated list of optional properties to include in the response. Specify any properties excluded by default that you wish to see. |
pagination_offset_token | string | Optional | Offset token to fetch the next page of results. Use the token returned from a previous request's pagination. |
results_per_page | integer | Optional | Number of project templates to return per page. Must be between 1 and 100. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
object_gid | string | Required | Globally unique identifier (GID) for the Asana object (project, portfolio, or goal) to fetch status updates from. |
created_since_time | string | Optional | Return statuses created after the specified time. Use ISO 8601 format. |
enable_pretty_output | boolean | Optional | Enable pretty JSON output with line breaks and indentation for readability. Mainly used for debugging, as it increases response size. |
optional_fields_to_include | array<string> | Optional | List the optional properties to include in the response. Provide as a comma-separated list of property names. |
pagination_offset_token | string | Optional | Token to fetch the next page of results. Use an offset returned from a previous paginated request. |
results_per_page | integer | Optional | Number of results to return per page. Must be between 1 and 100. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
task_identifier | string | Required | The unique identifier of the task to retrieve tags for in Asana. |
enable_pretty_output | boolean | Optional | Set to true to receive the response in a formatted, readable form. Useful for debugging as it increases response size and time. |
include_optional_fields | array<string> | Optional | List of optional properties to include in the response as comma-separated values. |
pagination_offset_token | string | Optional | An offset token for paginating results. Use the token from a previous response to access subsequent pages. |
results_per_page | integer | Optional | Number of objects to return per page. Must be between 1 and 100. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
project_global_id | string | Required | Globally unique identifier for the project in Asana. |
enable_pretty_output | boolean | Optional | Set 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_fields | array<string> | Optional | Comma-separated list of properties to include in the response. Opt-in to get specific data fields from the endpoint. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
task_id | string | Required | The global ID of the task to retrieve dependencies for in Asana. |
enable_pretty_output | boolean | Optional | Enable pretty formatting for output; useful for debugging. Increases response size and time. |
included_fields | array<string> | Optional | Comma-separated list of properties to include in the response. Some properties are excluded by default. |
pagination_offset_token | string | Optional | The offset token for pagination, used to retrieve the next page of results. Pass this only if paginating a previous request. |
results_per_page | integer | Optional | Specify the number of task dependencies to return per page. Must be between 1 and 100. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
task_identifier | string | Required | The unique identifier of the task to retrieve dependents for. |
enable_pretty_output | boolean | Optional | Enable this for JSON responses with readable line breaks and indentation. Use mainly for debugging. |
include_optional_fields | array<string> | Optional | A list of optional properties to include in the response, specified as strings. |
pagination_offset | string | Optional | Offset 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_page | integer | Optional | Number of results to return per page, between 1 and 100. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
task_identifier | string | Required | Specify the unique identifier of the Asana task to retrieve detailed information. |
enable_pretty_output | boolean | Optional | Set to true for a prettily formatted response, which may increase response time and size. Best used for debugging. |
include_optional_properties | array<string> | Optional | Specify optional task properties to include in the response. Use a list of strings representing property names. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
section_unique_identifier | string | Required | The globally unique identifier for the section in Asana to fetch tasks from. Required to specify the exact section targeted. |
completed_since_filter | string | Optional | Return tasks incomplete or completed since a specific time. Use a date-time string or 'now'. |
enable_pretty_output | boolean | Optional | Enable pretty formatting of the response for readability. Increases response time and size. Use mainly for debugging. |
optional_fields_to_include | array<string> | Optional | Comma-separated list of optional properties to include in the response. |
pagination_offset | string | Optional | Offset token for pagination. Use it to fetch the next page of results. If not provided, the first page will be returned. |
results_per_page | integer | Optional | Number of tasks to return per page, between 1 and 100. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
tag_global_id | string | Required | Globally unique identifier for the tag to retrieve associated tasks. |
enable_pretty_output | boolean | Optional | Formats the response for readability with line breaks and indentation. Use true only during debugging due to increased response size. |
optional_fields_to_include | array<string> | Optional | List of optional property names to include in the response for each task (comma-separated). |
pagination_offset | string | Optional | A 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_page | integer | Optional | The number of task objects to return per page, ranging from 1 to 100. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
task_identifier | string | Required | The unique identifier for the task to retrieve stories from. |
enable_pretty_output | boolean | Optional | Set to true for a readable, pretty format with line breaks and indentation. Useful for debugging. This will increase response time and size. |
include_optional_fields | array<string> | Optional | List of optional resource properties to include, specified as an array of strings. |
pagination_offset | string | Optional | An 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_page | integer | Optional | Specify the number of stories to return per page, between 1 and 100. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
task_id | string | Required | The unique identifier of the task to retrieve subtasks for. |
enable_pretty_output | boolean | Optional | Enable to receive the response in a 'pretty' format with line breaks and indentation. Useful for debugging. May increase response time and size. |
include_optional_fields | array<string> | Optional | Comma-separated list of optional properties to include in the response. |
pagination_offset | string | Optional | An 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_page | integer | Optional | Specify the number of subtasks to return per page. Must be between 1 and 100. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
team_membership_id | string | Required | The unique identifier for the specific team membership to retrieve. |
enable_pretty_output | boolean | Optional | Enable pretty formatting for the response with line breaks and indentation. Useful for debugging, but increases response time and size. |
include_optional_properties | array<string> | Optional | A list of optional properties to include in the response, specified as strings. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
enable_pretty_output | boolean | Optional | Return response in a readable format with line breaks and indentation. Ideal for debugging. |
optional_fields_to_include | array<string> | Optional | List the properties to include in the response, as some are excluded by default. |
pagination_offset_token | string | Optional | An offset token for pagination. Use a previously returned token to access subsequent pages. If omitted, the first page is returned. |
results_per_page | integer | Optional | Specify the number of results to return per page. Must be between 1 and 100. |
team_identifier | string | Optional | Globally unique identifier for the team in Asana. |
user_identifier | string | Optional | A string identifying a user. Use 'me', an email, or a user gid. Must be used with 'workspace'. |
workspace_id | string | Optional | Globally unique identifier for the workspace. This parameter must be used with the user_id parameter. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
team_identifier | string | Required | Globally unique identifier for the team whose projects are to be retrieved. It is required to specify the team. |
enable_pretty_output | boolean | Optional | Enable pretty formatting for the response, making it more readable. Use mainly for debugging due to increased response size. |
include_optional_properties | array<string> | Optional | A list of optional properties to include in the response for the projects. Specify as a list of strings. |
only_archived_projects | boolean | Optional | Return projects based on their archived status. True for archived projects, False for non-archived projects. |
pagination_offset_token | string | Optional | Offset 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_page | integer | Optional | Number of projects to return per page, between 1 and 100. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
team_global_identifier | string | Required | Globally unique identifier for the Asana team to retrieve users from. |
enable_pretty_output | boolean | Optional | Enable pretty output with line breaks and indentation for readability. Recommended for debugging as it increases response time and size. |
include_optional_fields | array<string> | Optional | Comma-separated list of properties you wish to include in the response. These are excluded by default. |
pagination_offset_token | string | Optional | Offset token for pagination. Use this token from a previous response to fetch the next page of results. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
time_period_id | string | Required | Globally unique identifier for the time period to retrieve its record. |
enable_pretty_output | boolean | Optional | Enable pretty formatting for output. Use only for debugging as it increases response size and processing time. |
include_optional_properties | array<string> | Optional | List of property names to include in the response. These properties are excluded by default. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
workspace_id | string | Required | Globally unique identifier for the Asana workspace. |
enable_pretty_output | boolean | Optional | Set to true to receive formatted, readable output mainly for debugging, increasing response size. |
end_date | string | Optional | The end date for time periods in ISO 8601 format. Specify the last date to include in the returned results. |
include_optional_properties | array<string> | Optional | A list of optional property names to include in the response, specified as an array of strings. |
pagination_offset | string | Optional | Offset 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_page | integer | Optional | The number of results to return per page, from 1 to 100. |
start_date | string | Optional | Start date for the time period in ISO 8601 format. Determines the beginning of the time period records to be retrieved. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
task_id | string | Required | The unique identifier for the task to retrieve time tracking entries for. |
enable_pretty_output | boolean | Optional | Set to true for a readable, pretty-formatted output. Recommended for debugging as it may increase response time and size. |
include_optional_fields | array<string> | Optional | Comma-separated list of optional properties to include in the response, enhancing the returned resource details. |
pagination_offset | string | Optional | Token for pagination; use to retrieve the next set of results. If not provided, the first page is returned. |
results_per_page | integer | Optional | Number of time tracking entries to return per page, must be between 1 and 100. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
time_tracking_entry_id | string | Required | Globally unique identifier for the time tracking entry. Used to specify which entry to retrieve. |
enable_pretty_output | boolean | Optional | Enable 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_properties | array<string> | Optional | A 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
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
user_identifier | string | Required | A string to identify a user, which can be 'me', an email, or a user's gid. |
enable_pretty_output | boolean | Optional | Set 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_properties | array<string> | Optional | Specify properties to include in the response using a comma-separated list of strings. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
user_identifier | string | Required | String to identify a user: 'me', an email, or a user GID. |
workspace_id | string | Required | The unique identifier of the Asana workspace to retrieve favorites from. |
favorites_resource_type | string | Optional | Specifies the type of favorites to return (e.g., 'portfolio', 'project'). |
include_optional_fields | array<string> | Optional | Specify a list of optional properties to include in the response, separated by commas. |
pagination_offset | string | Optional | An offset token for pagination. Use a token returned from a previous request to navigate pages. If not provided, the first page is returned. |
pretty_output | boolean | Optional | Set to true for readable, formatted output with line breaks and indentation, ideal for debugging. |
results_per_page | integer | Optional | Specifies the number of objects to return per page, between 1 and 100. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
workspace_identifier | string | Required | The unique identifier for the workspace or organization to filter portfolios on. |
enable_pretty_output | boolean | Optional | Enable pretty formatting for the output, improving readability with line breaks and indentation. This may increase response size and time, suitable for debugging. |
include_optional_fields | array<string> | Optional | Comma-separated list of properties to include in the response, allowing retrieval of additional optional fields. |
pagination_offset_token | string | Optional | A 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_identifier | string | Optional | Specify the user who owns the portfolio. Only applicable if using a Service Account for accessing portfolios owned by different users. |
results_per_page | integer | Optional | The number of portfolios to return per page. Must be between 1 and 100. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
user_task_list_id | string | Required | Globally unique identifier for the user's task list. This ID is required to fetch tasks from the specified user list. |
enable_pretty_output | boolean | Optional | Enable 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_since | string | Optional | Return only tasks that are either incomplete or completed since this date-time or the keyword 'now'. |
include_optional_fields | array<string> | Optional | List the optional properties to include in the response, as a list of strings. These properties are excluded by default. |
pagination_offset_token | string | Optional | Offset 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_page | integer | Optional | Specify the number of tasks to return per page, between 1 and 100. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
user_identifier | string | Required | A string identifying a user, which can be 'me', an email, or the user's gid. |
workspace_identifier | string | Required | Globally unique identifier for the workspace in Asana. |
enable_pretty_output | boolean | Optional | Enable pretty formatting for the response output with line breaks and indentation, useful for debugging. It increases response size and time. |
include_optional_fields | array<string> | Optional | A list of optional properties to include in the response, specified as strings. Use to get excluded fields. |
pagination_offset | string | Optional | Offset token for pagination. Use the offset to get the next page of results, returned from a previous paginated request. |
results_per_page | integer | Optional | Number of records to return per page, ranging from 1 to 100. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
user_identifier | string | Required | String identifying a user. Use 'me', an email, or a user gid. |
enable_pretty_output | boolean | Optional | If true, provides the response in a readable, pretty format with line breaks and indentation. Useful for debugging. |
include_optional_fields | array<string> | Optional | Comma-separated list of optional user properties to include in the response. |
page_offset_token | string | Optional | Token to fetch the next page of results from a paginated request. Use a token returned from a previous response. |
results_per_page | integer | Optional | Number of objects to return per page, between 1 and 100. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
enable_pretty_output | boolean | Optional | Enable for pretty, readable response. Ideal for debugging as it increases response time and size. |
include_optional_properties | array<string> | Optional | Comma-separated list of optional fields to include in the response. Use this to include properties that are excluded by default. |
pagination_offset | string | Optional | An offset token for paginating through the results. Use the token returned from a previous request to access the next page. |
results_limit_per_page | integer | Optional | Specify the number of workspaces to return per page. Must be between 1 and 100. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
workspace_global_id | string | Required | Globally unique identifier for the Asana workspace or organization. |
enable_pretty_output | boolean | Optional | Enable 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_properties | array<string> | Optional | List the optional properties to include, as a comma-separated list, to extend the default fields in the workspace record. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
workspace_global_id | string | Required | Globally unique identifier for the workspace or organization in Asana. |
enable_pretty_output | boolean | Optional | Enable pretty output for better readability. Recommended for debugging as it increases response size and takes extra time. |
sync_token | string | Optional | A 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
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
workspace_membership_id | string | Required | The unique identifier for the workspace membership to retrieve. |
enable_pretty_output | boolean | Optional | Set to true for "pretty" JSON formatting with line breaks and indentation. Increases response time and size; use for debugging. |
include_optional_properties | array<string> | Optional | List of specific properties to include in the response, as some are excluded by default. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
workspace_global_id | string | Required | A globally unique identifier for the workspace or organization to fetch memberships for. |
enable_pretty_output | boolean | Optional | Enable pretty output with line breaks and indentation for debugging purposes. |
include_optional_fields | array<string> | Optional | An array of strings specifying optional properties to include in the response. |
pagination_offset | string | Optional | Offset 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_page | integer | Optional | Specify the number of membership records to return per page, from 1 to 100. |
user_identifier | string | Optional | A string to identify a user, such as 'me', an email, or a user's gid in Asana. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
workspace_identifier | string | Required | Globally unique identifier for the workspace or organization in Asana. |
archived_projects_only | boolean | Optional | Specify `true` to return only archived projects, and `false` to include unarchived ones. |
enable_pretty_output | boolean | Optional | Enable pretty formatting for the response output. Use this for a readable JSON format, mainly during debugging. |
optional_fields_to_include | array<string> | Optional | Specify a list of property names to include in the response. These properties are not included by default. |
pagination_offset_token | string | Optional | Offset token for pagination. Use to request subsequent pages. If omitted, returns the first page. Only use tokens from previous requests. |
results_per_page | integer | Optional | Specify the number of project records to return per page. Must be between 1 and 100. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
workspace_unique_id | string | Required | Globally unique identifier for the workspace or organization in Asana. |
enable_pretty_output | boolean | Optional | Set to true for a "pretty" response with indentation and line breaks. Recommended for debugging as it increases response size and time. |
include_optional_fields | array<string> | Optional | List properties to include in the response. Provide these as an array of strings to retrieve additional user information beyond the default fields. |
pagination_offset_token | string | Optional | An 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
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
mode | string | Required | Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operationget_request_schemaexecute |
request_body | string | Optional | Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema' |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
parent_object_id | string | Optional | Globally unique ID of the Asana parent object: goal, project, portfolio, or team. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
mode | string | Required | Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operationget_request_schemaexecute |
project_template_id | string | Optional | Globally 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_properties | array<string> | Optional | A list of optional properties to include in the response. Provide as a comma-separated list. Only used when mode is 'execute'. |
enable_pretty_output | boolean | Optional | Enable pretty formatting for the response. Use this for debugging purposes as it increases response time and size. Only used when mode is 'execute'. |
request_body | string | Optional | Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema' |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
project_global_id | string | Required | Globally unique identifier for the project in Asana. |
enable_pretty_output | boolean | Optional | If 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_id | string | Optional | The ID of the section after which the given section will be inserted. Specify to reorder sections within the same project. |
insert_before_section_id | string | Optional | Specify the section ID to place the given section immediately before it. |
section_to_reorder | string | Optional | Globally unique identifier for the section to move within the project. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
access_request_identifier | string | Required | Globally unique identifier for the access request to be rejected. This value is required for identifying which access request to reject in Asana. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
portfolio_global_id | string | Required | Globally unique identifier for the portfolio to identify which portfolio the custom field should be removed from. |
custom_field_id_to_remove | string | Optional | The unique identifier of the custom field to be removed from the portfolio. |
enable_pretty_output | boolean | Optional | Enable pretty format for the output, adding line breaks and indentation for readability. Increases response size and processing time, recommended for debugging. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
project_unique_id | string | Required | Globally unique identifier for the Asana project. |
custom_field_id_to_remove | string | Optional | The ID of the custom field to remove from the specified project in Asana. |
enable_pretty_output | boolean | Optional | Formats the response in a readable way with line breaks and indentation. Use for debugging as it increases response time and size. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
project_global_id | string | Required | Globally unique identifier for the project in Asana. |
enable_pretty_output | boolean | Optional | Set to true to format the response with line breaks and indentation for readability. Useful for debugging. |
include_optional_properties | array<string> | Optional | A 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_unfollow | string | Optional | Array of user identifiers (e.g. "me", email, or gid) to remove from following the project. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
goal_unique_id | string | Required | Globally unique identifier for the goal to remove followers from. |
enable_pretty_output | boolean | Optional | Enable pretty JSON output with line breaking and indentation. Useful for debugging; increases response time and size. |
followers_to_remove | array<string> | Optional | An array of user identifiers to remove as followers. These can be "me", an email, or a user gid. |
included_optional_fields | array<string> | Optional | Comma-separated list of optional properties to include in the response for additional details. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
goal_global_id | string | Required | Globally unique identifier for the goal to identify which goal is being modified. |
provide_pretty_output | boolean | Optional | Provides pretty-printed output for debugging, enhancing readability with line breaks and indentation. Increases response size and time. |
supporting_resource_gid | string | Optional | The globally unique identifier (gid) of the supporting resource (goal, project, task, or portfolio) to remove from the parent goal. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
portfolio_identifier | string | Required | Globally unique identifier for the portfolio to remove the item from. |
enable_pretty_output | boolean | Optional | Enable this to receive the response in a readable, formatted way. This can increase response size and is best for debugging. |
item_to_remove | string | Optional | Specify the ID of the item to be removed from the portfolio. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
project_identifier | string | Required | Globally unique identifier for the project. |
enable_pretty_output | boolean | Optional | Set to true for formatted, human-readable JSON. Increases response size; use for debugging. |
include_optional_fields | array<string> | Optional | A list of optional fields to include in the response. Use a comma-separated list to specify. |
user_identifiers | string | Optional | Array of user identifiers to be removed from the project. Accepts "me", email, or user gid. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
portfolio_unique_id | string | Required | Globally unique identifier for the portfolio to modify. Required for removing members. |
enable_pretty_output | boolean | Optional | Enable to format the response with line breaks and indentation for readability. Recommended only for debugging. |
include_optional_properties | array<string> | Optional | Comma-separated list of properties to include in the response, allowing for additional data retrieval. |
members_to_remove | string | Optional | List of user identifiers to remove from the portfolio. Use 'me', an email, or user gid. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
task_identifier | string | Required | The unique identifier of the task from which the tag should be removed. |
enable_pretty_output | boolean | Optional | If true, formats the response for readability with line breaks and indentation. Use primarily for debugging. |
tag_gid_to_remove | string | Optional | The GID of the tag to be removed from the task in Asana. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
task_id | string | Required | The unique identifier of the task to operate on for removing dependencies. |
enable_pretty_output | boolean | Optional | Set to true to receive a formatted, readable response. Useful for debugging, but increases response size and time. |
task_dependency_ids_to_remove | array<string> | Optional | An array of task GIDs representing dependencies to be removed from the specified task. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
task_id | string | Required | The unique identifier of the task to operate on. |
dependents_task_ids | array<string> | Optional | An array of task GIDs that should be unlinked from the specified task. |
enable_pretty_output | boolean | Optional | Set to true for prettified JSON output. Recommended only for debugging as it increases response size and time. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
task_identifier | string | Required | The unique identifier of the task to remove from the project. |
enable_pretty_output | boolean | Optional | Enable 'pretty' response formatting. Provides line breaks and indentation for readability, useful mainly for debugging. |
project_to_remove_task_from | string | Optional | The identifier of the project from which the task will be removed. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
team_global_identifier | string | Required | Globally unique identifier for the team to remove a user from. |
enable_pretty_output | boolean | Optional | Enable pretty JSON formatting for the response. This increases readability but also response size, so it's advisable for debugging. |
user_identifier | string | Optional | A string identifying the user to be removed. It can be 'me', an email, or the user's gid. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
workspace_identifier | string | Required | Globally unique identifier for the workspace or organization in Asana. |
enable_pretty_output | boolean | Optional | Enable to receive formatted and more readable output. Use for debugging due to increased response size and time. |
user_identifier | string | Optional | Identifies the user to be removed. Accepts 'me', an email, or a globally unique user ID. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
custom_field_id | string | Required | Globally unique identifier for the custom field to be modified. |
enable_pretty_output | boolean | Optional | Enable pretty output for a more readable JSON response format, useful for debugging. |
enum_option_gid_to_relocate | string | Optional | The globally unique identifier (GID) of the enum option to relocate within the custom field. |
include_optional_properties | array<string> | Optional | A list of resource properties to include in the response, which are excluded by default. This should be a list of strings. |
insert_after_enum_option | string | Optional | The 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_gid | string | Optional | GID of an existing enum option before which the new option should be inserted. Cannot be used with after_enum_option. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
enable_pretty_output | boolean | Optional | Enable to receive the response in a formatted JSON with proper indentation. Increases response size and time; use primarily for debugging. |
include_optional_properties | array<string> | Optional | List of property names to include in the export, separated by commas. Use to include non-default properties. |
organization_id | string | Optional | Globally unique identifier for the workspace or organization to be exported in Asana. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
workspace_unique_id | string | Required | Globally unique identifier for the workspace or organization to filter the audit log events. |
actor_id_filter | string | Optional | Filter events to those triggered by the actor with this unique ID. |
actor_type_filter | string | Optional | Specify the actor type to filter events. Use only if not querying by actor ID. |
event_type_filter | string | Optional | Specify the type of events to filter. Refer to the supported audit log events for valid types. |
filter_by_resource_id | string | Optional | Filter events based on the specific resource ID to retrieve only those associated with this ID. |
filter_events_end_time | string | Optional | Filter events to include only those created before this date and time (exclusive). |
pagination_offset | string | Optional | Offset 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_page | integer | Optional | Set the number of audit log events to return per page of results, between 1 and 100. |
start_time_filter | string | Optional | Filter events created on or after this time (inclusive). Provide in ISO 8601 format. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
portfolio_identifier | string | Required | Globally unique identifier for the portfolio required to fetch membership records. |
enable_pretty_output | boolean | Optional | Set to true to receive a readable, formatted response. Use this primarily for debugging due to increased response size and time. |
include_optional_fields | array<string> | Optional | Specify a list of optional properties to include, using a comma-separated list. |
pagination_offset_token | string | Optional | Offset token used for pagination to retrieve the next page of results. Use the token returned from a previous request. |
results_per_page | integer | Optional | Number of portfolio memberships to return per page, between 1 and 100. |
user_identifier | string | Optional | A string identifying a user. This can be 'me', an email, or the user's gid. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
task_custom_id | string | Required | The generated custom ID used to identify a specific task in Asana. |
workspace_global_id | string | Required | Globally unique identifier for the workspace or organization in Asana. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
webhook_global_identifier | string | Required | Globally unique identifier for the webhook to retrieve its full record. |
enable_pretty_output | boolean | Optional | Enables pretty output formatting with line breaks and indentation. Use this for debugging, but be aware it increases response time and size. |
included_fields | array<string> | Optional | List of optional properties to include in the response. Provide these as an array of strings. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
workspace_identifier | string | Required | Globally unique identifier for the Asana workspace or organization. |
enable_pretty_output | boolean | Optional | Enable pretty JSON output with proper line breaking and indentation intended for debugging. This may increase response time and size. |
include_optional_properties | array<string> | Optional | List of optional tag properties to include, specified as strings. These properties are excluded by default. |
offset_token | string | Optional | The offset token to retrieve the next page of results. Use a token from a previous response for pagination. |
results_per_page | integer | Optional | Specify the number of tag records to return per page, between 1 and 100. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
workspace_global_id | string | Required | Globally unique identifier for the workspace or organization where tasks are searched. |
all_tags_filters | string | Optional | Comma-separated list of tag IDs to filter tasks that have all specified tags. |
assigned_by_user_ids | string | Optional | A comma-separated list of user IDs to filter tasks assigned by specific users. |
assignee_identifiers_any | string | Optional | Provide a comma-separated list of user identifiers for any assignee to include in the search. |
before_modified_on_date | string | Optional | ISO 8601 date string to filter tasks modified before this date. |
completed_at_after | string | Optional | Specify an ISO 8601 datetime string to filter tasks completed after this date and time. |
completed_at_before_datetime | string | Optional | Filter tasks completed before the specified ISO 8601 datetime. |
completed_on_after_date | string | Optional | Specify an ISO 8601 date to filter tasks completed after this date. |
completed_on_before_date | string | Optional | Filter tasks completed before a specific date using an ISO 8601 date string. |
completed_on_date | string | Optional | Filter tasks by their completion date using an ISO 8601 date string or `null` for no specific date. |
created_after_date | string | Optional | Specify the earliest creation date for tasks using an ISO 8601 date string. Filters tasks created after this date. |
created_after_datetime | string | Optional | Filter tasks created after this ISO 8601 datetime string. |
created_at_before | string | Optional | An ISO 8601 datetime string to filter tasks created before this date and time. |
created_by_users | string | Optional | Comma-separated list of user IDs to filter tasks created by specific users. |
created_on_before_date | string | Optional | Filter tasks created before a specific date using an ISO 8601 date string format. |
created_on_date | string | Optional | Filter tasks by their creation date using an ISO 8601 date string or `null`. |
due_at_after_datetime | string | Optional | Specify the start date and time for tasks due after this point. Use an ISO 8601 datetime string. |
due_at_before | string | Optional | An ISO 8601 datetime string to filter tasks due before this date and time. |
due_date_on | string | Optional | Filter tasks due on a specific date using an ISO 8601 date string or specify `null` for tasks with no due date. |
enable_pretty_output | boolean | Optional | Formats the response with line breaks and indentation for readability. Use for debugging, as it increases response size and processing time. |
end_date_before_start_on | string | Optional | Filter tasks starting before a specified date, using an ISO 8601 date string. |
exclude_assigned_by_users | string | Optional | A comma-separated list of user IDs to exclude tasks assigned by these users. |
exclude_assignees | string | Optional | Comma-separated list of user identifiers to exclude from the search results. |
exclude_created_by_user_ids | string | Optional | Comma-separated list of user IDs to exclude from the search results. |
exclude_followers_by_user_ids | string | Optional | Comma-separated list of user identifiers to exclude from the followers filter. |
exclude_projects_by_id | string | Optional | A comma-separated list of project IDs to exclude from the search results. |
exclude_sections_by_id | string | Optional | Comma-separated list of section or column IDs to exclude from the search results. |
exclude_tags_by_ids | string | Optional | A comma-separated list of tag IDs to exclude from the search results. |
exclude_tasks_commented_by_users | string | Optional | Comma-separated list of user identifiers to exclude tasks commented on by these users. |
excluded_liked_by_user_ids | string | Optional | A comma-separated list of user IDs to exclude tasks liked by these users. |
filter_by_all_projects | string | Optional | Comma-separated list of project IDs to filter tasks that belong to all specified projects. |
filter_by_any_follower_ids | string | Optional | Filter tasks by providing a comma-separated list of user IDs who are followers of the tasks. |
filter_by_any_team_ids | string | Optional | Comma-separated list of team IDs to filter tasks associated with any of these teams. |
filter_due_date_before | string | Optional | Specify tasks with a due date earlier than this ISO 8601 date string. |
filter_modified_date_start | string | Optional | Start date to filter tasks modified after this date in ISO 8601 format. |
filter_sections_all | string | Optional | Comma-separated list of section or column IDs to filter tasks by inclusion in all specified sections. |
filter_tasks_with_attachments | boolean | Optional | Set to true to filter tasks that have attachments, and false to include all tasks regardless of attachments. |
filter_tasks_with_incomplete_dependencies | boolean | Optional | Filter tasks to those with incomplete dependencies. Use true to apply the filter. |
filter_to_completed_tasks | boolean | Optional | Set to true to filter and display only completed tasks. |
filter_to_incomplete_tasks_with_dependents | boolean | Optional | Set to true to filter tasks to those that are incomplete and have dependents. |
include_any_tags_ids | string | Optional | Comma-separated list of tag IDs to include in the search filter. |
include_only_subtasks | boolean | Optional | Set to true to include only subtasks in the results, false to include all tasks. |
include_sections_in_search | string | Optional | A comma-separated list of section or column IDs to filter tasks in the search. |
included_optional_properties | array<string> | Optional | List of optional properties to include for each returned task. Provide as comma-separated values. |
last_modified_on | string | Optional | ISO 8601 date string or `null` to filter tasks based on the modification date. |
modified_after_datetime | string | Optional | Filter tasks modified after this ISO 8601 datetime string. |
modified_at_before_date | string | Optional | Filter tasks modified before this date. Use ISO 8601 datetime format. |
portfolio_ids_included | string | Optional | A comma-separated list of portfolio IDs to include in the search. |
project_ids_any | string | Optional | Comma-separated list of project IDs to include in the search. |
search_text | string | Optional | Full-text search on task names and descriptions within the workspace. |
sort_results_ascending | boolean | Optional | Set to true to sort search results in ascending order. Default is false. |
start_date_after | string | Optional | An ISO 8601 date string to filter tasks starting after this date. |
start_on_date | string | Optional | ISO 8601 date string specifying the start date of tasks to be searched, or `null` for unspecified. |
task_resource_subtype | string | Optional | Filter tasks by their resource subtype, such as 'default_task', 'milestone', or 'approval'. |
task_sort_order | string | Optional | Specify 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_date | string | Optional | Specify an ISO 8601 date string to filter tasks due after this date. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
access_request_message | string | Optional | Optional message providing context or additional information for the access request. |
target_gid | string | Optional | The GID of the project or portfolio you are requesting access to in Asana. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
mode | string | Required | Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operationget_request_schemaexecute |
incoming_web_request_trigger_id | string | Optional | The 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_body | string | Optional | Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema' |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
mode | string | Required | Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operationget_request_schemaexecute |
allocation_global_id | string | Optional | Globally 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_fields | array<string> | Optional | Comma-separated list of optional properties to include in the response. Only used when mode is 'execute'. |
enable_pretty_output | boolean | Optional | Set 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_body | string | Optional | Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema' |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
mode | string | Required | Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operationget_request_schemaexecute |
custom_field_global_id | string | Optional | Globally unique identifier for the custom field to be updated. Required when mode is 'execute', ignored when mode is 'get_request_schema'. |
include_optional_properties | array<string> | Optional | Comma-separated list of optional properties to include in the response, as the endpoint excludes some by default. Only used when mode is 'execute'. |
pretty_output | boolean | Optional | Set 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_body | string | Optional | Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema' |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
mode | string | Required | Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operationget_request_schemaexecute |
goal_unique_id | string | Optional | Globally unique identifier for the goal to be updated. Required when mode is 'execute', ignored when mode is 'get_request_schema'. |
included_goal_properties | array<string> | Optional | List of optional goal properties to include in the response. Provide as an array of strings. Only used when mode is 'execute'. |
enable_pretty_output | boolean | Optional | Set 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_body | string | Optional | Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema' |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
mode | string | Required | Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operationget_request_schemaexecute |
story_global_id | string | Optional | Globally unique identifier for the Asana story to be updated. Required when mode is 'execute', ignored when mode is 'get_request_schema'. |
include_optional_properties | array<string> | Optional | Comma-separated list of optional properties to include in the response. Defaults to excluding some properties. Only used when mode is 'execute'. |
enable_pretty_output | boolean | Optional | Set to true for a readable, formatted response. Use for debugging as it increases response size and time. Only used when mode is 'execute'. |
request_body | string | Optional | Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema' |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
mode | string | Required | Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operationget_request_schemaexecute |
tag_global_identifier | string | Optional | Globally unique identifier for the tag to update in Asana. Required when mode is 'execute', ignored when mode is 'get_request_schema'. |
include_optional_fields | array<string> | Optional | List of optional properties to include with the tag resource. Provide as an array of property names. Only used when mode is 'execute'. |
enable_pretty_output | boolean | Optional | Set 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_body | string | Optional | Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema' |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
enum_option_gid | string | Required | The globally unique identifier for the enum option to update. |
enum_option_color | string | Optional | The color of the enum option. Defaults to 'none' if not provided. |
enum_option_enabled | boolean | Optional | Indicates if the enum option is selectable for the custom field. Provide 'true' to make it selectable, 'false' otherwise. |
enum_option_name | string | Optional | The name of the enum option to be updated. |
include_optional_properties | array<string> | Optional | Provide a list of properties to include in the response, beyond the default set. |
pretty_output | boolean | Optional | Set to true to receive the response in a pretty-printed format. Increases response time and size, useful for debugging. |
resource_gid | string | Optional | Globally unique identifier for the resource as a string. |
resource_type | string | Optional | The base type of the resource, specified as a string. This is necessary for updating the enum option. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
goal_unique_identifier | string | Required | Globally unique identifier for the Asana goal to be updated. |
current_metric_value | number | Optional | The current numeric value of a goal metric. Required if metric type is number. |
include_optional_fields | array<string> | Optional | Comma-separated list of optional properties to include in the response. |
pretty_output | boolean | Optional | Set to true for a more readable response format, useful for debugging. |
resource_base_type | string | Optional | The base type of the resource to update. It must be a string indicating the type of resource. |
resource_unique_identifier | string | Optional | Globally unique identifier of the resource in Asana, represented as a string. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
mode | string | Required | Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operationget_request_schemaexecute |
goal_relationship_unique_id | string | Optional | The 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_properties | array<string> | Optional | Specify 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_output | boolean | Optional | Set to true for a readable response with indentation. Increases response size/time, recommended for debugging. Only used when mode is 'execute'. |
request_body | string | Optional | Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema' |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
membership_id | string | Required | Globally unique identifier for the membership to update. |
enable_pretty_output | boolean | Optional | If true, formats the response for readability with line breaks and indentation, useful for debugging. |
member_access_level | string | Optional | Specify 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
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
mode | string | Required | Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operationget_request_schemaexecute |
portfolio_unique_identifier | string | Optional | Globally unique identifier for the portfolio to be updated. Required when mode is 'execute', ignored when mode is 'get_request_schema'. |
include_optional_fields | array<string> | Optional | A list of optional portfolio properties to include in the response, specified as an array of strings. Only used when mode is 'execute'. |
enable_pretty_output | boolean | Optional | Provides formatted and indented output. Use primarily for debugging as it increases response size and processing time. Only used when mode is 'execute'. |
request_body | string | Optional | Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema' |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
mode | string | Required | Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operationget_request_schemaexecute |
project_brief_id | string | Optional | Globally unique identifier for the specific project brief to update. Required when mode is 'execute', ignored when mode is 'get_request_schema'. |
include_optional_properties | array<string> | Optional | Specify a list of properties to include in the response, separated by commas. Only used when mode is 'execute'. |
provide_pretty_output | boolean | Optional | If true, the response is formatted with line breaks and indentation for readability. Use primarily for debugging. Only used when mode is 'execute'. |
request_body | string | Optional | Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema' |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
mode | string | Required | Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operationget_request_schemaexecute |
project_global_id | string | Optional | Globally unique identifier for the project to be updated. Required when mode is 'execute', ignored when mode is 'get_request_schema'. |
include_optional_properties | array<string> | Optional | Comma-separated list of properties to include in the response, showing optional fields by default excluded. Only used when mode is 'execute'. |
enable_pretty_output | boolean | Optional | Enable 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_body | string | Optional | Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema' |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
section_global_identifier | string | Required | The globally unique identifier for the section to be updated in Asana. |
include_optional_properties | array<string> | Optional | Comma-separated list of properties to include in the response. Allows inclusion of optional fields excluded by default. |
insert_after_section_id | string | Optional | Identifier of an existing section after which the updated section should be inserted. Cannot be used with `insert_before_section_id`. |
pretty_output | boolean | Optional | Set to true for a readable, pretty formatted response with line breaks and indentation. Recommended for debugging as it increases response size. |
section_insert_before_id | string | Optional | The 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_name | string | Optional | The new name for the section. It cannot be an empty string. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
mode | string | Required | Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operationget_request_schemaexecute |
task_id | string | Optional | The unique identifier of the task to update in Asana. Required when mode is 'execute', ignored when mode is 'get_request_schema'. |
include_optional_properties | array<string> | Optional | Comma-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_enabled | boolean | Optional | Set to true for a formatted response with line breaks and indentation. Useful for debugging. Only used when mode is 'execute'. |
request_body | string | Optional | Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema' |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
task_identifier | string | Required | The unique identifier of the task to operate on. It should be a string. |
enable_pretty_output | boolean | Optional | Set 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_properties | array<string> | Optional | A list of optional task properties to include in the response. Use a list of property names. |
new_task_parent | string | Optional | The new parent task ID for the task, or null to remove its current parent. |
subtask_to_insert_after | string | Optional | Specify the subtask ID to insert the task after, or use 'null' to insert at the beginning of the list. |
subtask_to_insert_before | string | Optional | Specify a subtask ID to insert the task before, or null to place at the end of the list. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
mode | string | Required | Operation mode: 'get_request_schema' returns the OpenAPI spec for the request body, 'execute' performs the actual operationget_request_schemaexecute |
team_global_id | string | Optional | Globally 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_properties | array<string> | Optional | List of optional properties to include in the response. Use a list format for specifying multiple properties. Only used when mode is 'execute'. |
enable_pretty_output | boolean | Optional | Enable 'pretty' formatted output for easier readability in responses, increasing response size and time, mainly used for debugging. Only used when mode is 'execute'. |
request_body | string | Optional | Stringified JSON representing the request body. Required when mode is 'execute', ignored when mode is 'get_request_schema' |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
time_tracking_entry_id | string | Required | Globally unique identifier for the time tracking entry to be updated. |
duration_minutes_tracked | integer | Optional | The time in minutes tracked by the entry. Optional field. |
enable_pretty_output | boolean | Optional | Enable formatted output for easier readability. Use mainly for debugging as it increases response time and size. |
entry_logged_date | string | Optional | The date the entry is logged. Defaults to today if not specified. Use format 'YYYY-MM-DD'. |
include_optional_properties | array<string> | Optional | Comma-separated list of optional properties to include in the response. |
project_attributable_gid | string | Optional | Optional. The globally unique identifier (gid) of the project to which the time is attributable. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
workspace_global_id | string | Required | Globally unique identifier for the workspace or organization. |
enable_pretty_output | boolean | Optional | Enable this to receive the response in a readable and formatted style. Useful for debugging. May increase response size and time. |
include_optional_fields | array<string> | Optional | List of additional workspace properties to include in the response, comma-separated. |
resource_base_type | string | Optional | Specify the base type of the resource to update the workspace name. |
workspace_name | string | Optional | The new name for the Asana workspace you want to update. |
workspace_resource_gid | string | Optional | Globally unique identifier of the workspace resource. This is required to specify which workspace to update. |
Requirements
Output
json— Response 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
| Parameter | Type | Req. | Description |
|---|---|---|---|
workspace_id | string | Required | Globally unique identifier for the workspace or organization. |
enable_pretty_output | boolean | Optional | Enable pretty format for the response with proper indentation. Use for debugging due to increased response size, but not recommended for production. |
include_optional_fields | array<string> | Optional | A list of properties to include in the response, set as a comma-separated list to include optional fields in the result. |
resource_type | string | Optional | Specify the type of workspace objects to return, such as 'custom_field', 'portfolio', 'project', 'tag', 'task', or 'user'. |
results_count | integer | Optional | The number of results to return, ranging from 1 to 100. Default is 20. |
search_query | string | Optional | String to search for relevant workspace objects. An empty string will return results. |
search_result_resource_type | string | Optional | Specify 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
Output
json— Response from the API endpoint 'typeaheadForWorkspace'.