AsanaApi

The AsanaApi MCP Server offers a comprehensive suite of tools for managing and interacting with Asana’s features. Users can perform a variety of actions, including:

Available Tools

AsanaApi.GetPendingAccessRequests

Fetch pending access requests for a target object.

Parameters

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

AsanaApi.SubmitAccessRequestAsana

Submit a new access request for Asana projects or portfolios.

Parameters

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

AsanaApi.ApproveAccessRequest

Approves an access request for a target object in Asana.

Parameters

• access_request_global_id (string, required) Globally unique identifier for the specific access request to approve.

AsanaApi.RejectAccessRequest

Reject an access request for a target object.

Parameters

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

AsanaApi.GetAllocationRecord

Fetch the complete allocation record for a given ID.

Parameters

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

AsanaApi.UpdateAllocation

Update an existing allocation in Asana.

Parameters

• mode (Enum ToolMode, required) Operation mode: ‘get_request_schema’ returns the OpenAPI spec for the request body, ‘execute’ performs the actual operation
• 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’

AsanaApi.DeleteAllocation

Deletes a specific allocation in Asana.

Parameters

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

AsanaApi.GetProjectAllocations

Retrieve allocations for a specific project, user, or placeholder.

Parameters

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

AsanaApi.CreateAllocation

Creates a new allocation in Asana and returns its details.

Parameters

• mode (Enum ToolMode, required) Operation mode: ‘get_request_schema’ returns the OpenAPI spec for the request body, ‘execute’ performs the actual operation
• 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’

AsanaApi.FetchAttachmentDetails

Fetch the full record of a specific attachment.

Parameters

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

AsanaApi.DeleteAttachment

Delete a specific attachment in Asana.

Parameters

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

AsanaApi.GetAttachments

Retrieve all attachments for a specified Asana object.

Parameters

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

AsanaApi.RetrieveAuditLogEvents

Retrieve audit log events from your Asana domain.

Parameters

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

AsanaApi.CreateParallelRequestsAsana

Execute multiple requests to Asana’s API simultaneously.

Parameters

• mode (Enum ToolMode, required) Operation mode: ‘get_request_schema’ returns the OpenAPI spec for the request body, ‘execute’ performs the actual operation
• 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’

AsanaApi.GetCustomFieldSettingsForProject

Get custom field settings for a specified project.

Parameters

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

AsanaApi.GetPortfolioCustomFieldSettings

Retrieve custom field settings for an Asana portfolio.

Parameters

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

AsanaApi.CreateCustomFieldInWorkspace

Create a new custom field in an Asana workspace.

Parameters

• mode (Enum ToolMode, required) Operation mode: ‘get_request_schema’ returns the OpenAPI spec for the request body, ‘execute’ performs the actual operation
• 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’

AsanaApi.GetCustomFieldMetadata

Retrieve complete metadata of a custom field in Asana.

Parameters

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

AsanaApi.UpdateAsanaCustomField

Update specific fields of an Asana custom field.

Parameters

• mode (Enum ToolMode, required) Operation mode: ‘get_request_schema’ returns the OpenAPI spec for the request body, ‘execute’ performs the actual operation
• 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’

AsanaApi.DeleteCustomField

Delete a specific custom field in Asana.

Parameters

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

AsanaApi.GetCustomFieldsForWorkspace

Retrieve custom fields for a specific workspace.

Parameters

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

AsanaApi.AddEnumOptionToCustomField

Add an enum option to a custom field in Asana.

Parameters

• mode (Enum ToolMode, required) Operation mode: ‘get_request_schema’ returns the OpenAPI spec for the request body, ‘execute’ performs the actual operation
• 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’

AsanaApi.ReorderEnumOptionCustomField

Reorder enum options in a custom field.

Parameters

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

AsanaApi.UpdateEnumOption

Update an existing enum option in Asana custom fields.

Parameters

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

AsanaApi.GetCustomTypes

Retrieve all custom types for a project in Asana.

Parameters

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

AsanaApi.GetCustomTypeDetails

Retrieve complete details of a specific custom type in Asana.

Parameters

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

AsanaApi.FetchAsanaEvents

Fetches detailed records of recent Asana events.

Parameters

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

AsanaApi.InitiateGraphExport

Initiate a graph export job for Asana objects.

Parameters

• parent_object_id (string, optional) Globally unique ID of the Asana parent object: goal, project, portfolio, or team.

AsanaApi.InitiateBulkResourceExport

Initiate a bulk export of tasks, teams, or messages in a workspace.

Parameters

• mode (Enum ToolMode, required) Operation mode: ‘get_request_schema’ returns the OpenAPI spec for the request body, ‘execute’ performs the actual operation
• request_body (string, optional) Stringified JSON representing the request body. Required when mode is ‘execute’, ignored when mode is ‘get_request_schema’

AsanaApi.GetGoalRelationshipDetails

Retrieve details of a specific Asana goal relationship.

Parameters

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

AsanaApi.UpdateGoalRelationship

Update an existing goal relationship in Asana.

Parameters

• mode (Enum ToolMode, required) Operation mode: ‘get_request_schema’ returns the OpenAPI spec for the request body, ‘execute’ performs the actual operation
• 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’

AsanaApi.GetGoalRelationships

Retrieve compact goal relationship records from Asana.

Parameters

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

AsanaApi.CreateGoalSupportingRelationship

Add a supporting resource to a specific goal in Asana.

Parameters

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

AsanaApi.RemoveGoalRelationship

Removes a supporting relationship from a goal in Asana.

Parameters

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

AsanaApi.GetAsanaGoalDetails

Fetches detailed information for a specific Asana goal.

Parameters

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

AsanaApi.UpdateAsanaGoal

Update a specific goal in Asana.

Parameters

• mode (Enum ToolMode, required) Operation mode: ‘get_request_schema’ returns the OpenAPI spec for the request body, ‘execute’ performs the actual operation
• 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’

AsanaApi.DeleteAsanaGoal

Delete a specific goal in Asana.

Parameters

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

AsanaApi.GetCompactGoals

Retrieve compact goal records from Asana.

Parameters

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

AsanaApi.CreateAsanaGoal

Create a new goal in Asana workspace or team.

Parameters

• mode (Enum ToolMode, required) Operation mode: ‘get_request_schema’ returns the OpenAPI spec for the request body, ‘execute’ performs the actual operation
• 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’

AsanaApi.CreateGoalMetric

Create and add a goal metric to a specific goal.

Parameters

• mode (Enum ToolMode, required) Operation mode: ‘get_request_schema’ returns the OpenAPI spec for the request body, ‘execute’ performs the actual operation
• 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’

AsanaApi.UpdateGoalMetric

Updates a goal’s current metric value in Asana.

Parameters

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

AsanaApi.AddFollowersToGoal

Add followers to a specific goal in Asana.

Parameters

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

AsanaApi.RemoveGoalFollowers

Remove followers from a specific goal in Asana.

Parameters

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

AsanaApi.GetParentGoalsForGoal

Fetches parent goals for a specific Asana goal.

Parameters

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

AsanaApi.FetchJobDetails

Fetch complete details for a specific job record in Asana.

Parameters

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

AsanaApi.GetMemberships

Retrieve compact membership records from Asana.

Parameters

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

AsanaApi.CreateAsanaMembership

Create a new membership in Asana for goals, projects, portfolios, or custom fields.

Parameters

• mode (Enum ToolMode, required) Operation mode: ‘get_request_schema’ returns the OpenAPI spec for the request body, ‘execute’ performs the actual operation
• 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’

AsanaApi.GetMembershipInfo

Retrieve membership record details by ID.

Parameters

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

AsanaApi.UpdateMembership

Update an existing membership in Asana.

Parameters

• 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’).

AsanaApi.DeleteAsanaMembership

Delete a membership in Asana.

Parameters

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

AsanaApi.RequestOrganizationExport

Submit a request to export an organization in Asana.

Parameters

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

AsanaApi.GetOrganizationExportDetails

Fetch details of a specific organization export.

Parameters

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

AsanaApi.GetPortfolioMemberships

Retrieve portfolio memberships from Asana.

Parameters

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

AsanaApi.GetPortfolioMembership

Retrieve a single portfolio membership record.

Parameters

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

AsanaApi.RetrievePortfolioMemberships

Retrieve compact portfolio membership records for a portfolio.

Parameters

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

AsanaApi.GetUserOwnedPortfolios

Retrieve a list of portfolios owned by the user.

Parameters

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

AsanaApi.CreateAsanaPortfolio

Create a new portfolio in an Asana workspace.

Parameters

• mode (Enum ToolMode, required) Operation mode: ‘get_request_schema’ returns the OpenAPI spec for the request body, ‘execute’ performs the actual operation
• 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’

AsanaApi.GetPortfolioDetails

Retrieve complete details of a specific portfolio in Asana.

Parameters

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

AsanaApi.UpdatePortfolio

Update an existing Asana portfolio.

Parameters

• mode (Enum ToolMode, required) Operation mode: ‘get_request_schema’ returns the OpenAPI spec for the request body, ‘execute’ performs the actual operation
• 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’

AsanaApi.DeletePortfolio

Delete an existing portfolio in Asana.

Parameters

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

AsanaApi.GetPortfolioItems

Retrieve a list of items in a portfolio.

Parameters

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

AsanaApi.AddItemToPortfolio

Add an item to a portfolio in Asana.

Parameters

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

AsanaApi.RemoveItemFromPortfolio

Remove an item from a portfolio in Asana.

Parameters

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

AsanaApi.AddCustomFieldToPortfolio

Add a custom field setting to an Asana portfolio.

Parameters

• mode (Enum ToolMode, required) Operation mode: ‘get_request_schema’ returns the OpenAPI spec for the request body, ‘execute’ performs the actual operation
• 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’

AsanaApi.RemoveCustomFieldFromPortfolio

Removes a custom field from an Asana portfolio.

Parameters

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

AsanaApi.AddPortfolioMembers

Add specified users as members of a portfolio on Asana.

Parameters

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

AsanaApi.RemovePortfolioMembers

Remove specified members from a portfolio.

Parameters

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

AsanaApi.GetProjectBrief

Retrieve the full record for a project brief.

Parameters

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

AsanaApi.UpdateProjectBriefAsana

Update an Asana project brief.

Parameters

• mode (Enum ToolMode, required) Operation mode: ‘get_request_schema’ returns the OpenAPI spec for the request body, ‘execute’ performs the actual operation
• 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’

AsanaApi.DeleteProjectBrief

Delete a specific project brief in Asana.

Parameters

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

AsanaApi.CreateProjectBrief

Create a new project brief in Asana.

Parameters

• mode (Enum ToolMode, required) Operation mode: ‘get_request_schema’ returns the OpenAPI spec for the request body, ‘execute’ performs the actual operation
• 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’

AsanaApi.GetProjectMembershipDetails

Retrieve detailed information for a project membership in Asana.

Parameters

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

AsanaApi.GetProjectMemberships

Fetch project membership records from Asana.

Parameters

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

AsanaApi.GetProjectStatusUpdate

Fetches a complete status update record for a project.

Parameters

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

AsanaApi.DeleteProjectStatus

Delete a specific project status update in Asana.

Parameters

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

AsanaApi.GetProjectStatusUpdates

Fetch compact status updates for a given project.

Parameters

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

AsanaApi.CreateProjectStatusUpdate

Creates a new status update for a project.

Parameters

• mode (Enum ToolMode, required) Operation mode: ‘get_request_schema’ returns the OpenAPI spec for the request body, ‘execute’ performs the actual operation
• 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’

AsanaApi.GetProjectTemplateDetails

Retrieve complete details of a specific Asana project template.

Parameters

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

AsanaApi.DeleteProjectTemplate

Delete a specific existing project template in Asana.

Parameters

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

AsanaApi.GetAsanaProjectTemplates

Fetch project template records from Asana.

Parameters

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

AsanaApi.GetProjectTemplatesForTeam

Retrieve compact project template records for a team.

Parameters

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

AsanaApi.InstantiateProjectFromTemplate

Asynchronously instantiate a project from a template.

Parameters

• mode (Enum ToolMode, required) Operation mode: ‘get_request_schema’ returns the OpenAPI spec for the request body, ‘execute’ performs the actual operation
• 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’

AsanaApi.GetAsanaProjects

Fetch filtered project records from Asana.

Parameters

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

AsanaApi.CreateNewAsanaProject

Create a new project in an Asana workspace or team.

Parameters

• mode (Enum ToolMode, required) Operation mode: ‘get_request_schema’ returns the OpenAPI spec for the request body, ‘execute’ performs the actual operation
• 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’

AsanaApi.GetProjectDetails

Retrieve complete details of a specified Asana project.

Parameters

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

AsanaApi.UpdateProjectDetails

Update specific fields of an existing project.

Parameters

• mode (Enum ToolMode, required) Operation mode: ‘get_request_schema’ returns the OpenAPI spec for the request body, ‘execute’ performs the actual operation
• 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’

AsanaApi.DeleteAsanaProject

Delete a specific project in Asana.

Parameters

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

AsanaApi.AsanaDuplicateProject

Initiate duplication of a project in Asana.

Parameters

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

AsanaApi.GetProjectsForTask

Retrieve all projects associated with a specific task.

Parameters

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

AsanaApi.GetTeamProjects

Fetch the list of projects for a specified team.

Parameters

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

AsanaApi.CreateAsanaProjectForTeam

Create a new Asana project for a specific team.

Parameters

• mode (Enum ToolMode, required) Operation mode: ‘get_request_schema’ returns the OpenAPI spec for the request body, ‘execute’ performs the actual operation
• 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’

AsanaApi.GetWorkspaceProjects

Fetch compact project records for a workspace.

Parameters

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

AsanaApi.CreateProjectInWorkspace

Create a new project in a specified workspace.

Parameters

• mode (Enum ToolMode, required) Operation mode: ‘get_request_schema’ returns the OpenAPI spec for the request body, ‘execute’ performs the actual operation
• 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’

AsanaApi.AddCustomFieldSettingToProject

Add a custom field setting to a project in Asana.

Parameters

• mode (Enum ToolMode, required) Operation mode: ‘get_request_schema’ returns the OpenAPI spec for the request body, ‘execute’ performs the actual operation
• 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’

AsanaApi.RemoveCustomFieldFromProject

Remove a custom field setting from an Asana project.

Parameters

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

AsanaApi.GetTaskCountsForProject

Retrieve task count details for a specific project in Asana.

Parameters

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

AsanaApi.AddMembersToProject

Add specified users as members of a project in Asana.

Parameters

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

AsanaApi.RemoveMembersFromProject

Remove specified users from a project in Asana.

Parameters

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

AsanaApi.AddFollowersToProject

Add specified users as followers to an Asana project.

Parameters

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

AsanaApi.RemoveFollowersFromProject

Remove specified users from following a project in Asana.

Parameters

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

AsanaApi.CreateProjectTemplate

Create a project template in Asana asynchronously.

Parameters

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

AsanaApi.FetchReactionsByEmoji

Retrieve reactions with a specific emoji on an object.

Parameters

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

AsanaApi.TriggerAsanaRule

Trigger a rule in Asana using an incoming web request.

Parameters

• mode (Enum ToolMode, required) Operation mode: ‘get_request_schema’ returns the OpenAPI spec for the request body, ‘execute’ performs the actual operation
• 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’

AsanaApi.GetAsanaSection

Retrieve a complete record of a single Asana section.

Parameters

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

AsanaApi.UpdateSectionNameAsana

Update the name of a specific section in Asana.

Parameters

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

AsanaApi.DeleteAsanaSection

Delete a specific, existing section in Asana.

Parameters

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

AsanaApi.GetProjectSections

Fetch compact records for sections in a specified project.

Parameters

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

AsanaApi.CreateSectionInProject

Create a new section in an Asana project.

Parameters

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

AsanaApi.AddTaskToSection

Add a task to a specified section in Asana.

Parameters

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

AsanaApi.MoveSectionInProject

Reorder sections within a project in Asana.

Parameters

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

AsanaApi.FetchStatusUpdate

Fetch the complete record for a specific status update.

Parameters

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

AsanaApi.DeleteStatusUpdate

Delete a specific status update from Asana.

Parameters

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

AsanaApi.GetStatusUpdatesForObject

Retrieve status updates for a specified object in Asana.

Parameters

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

AsanaApi.CreateStatusUpdate

Create a new status update on an object in Asana.

Parameters

• mode (Enum ToolMode, required) Operation mode: ‘get_request_schema’ returns the OpenAPI spec for the request body, ‘execute’ performs the actual operation
• 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’

AsanaApi.GetAsanaStory

Fetch the full record of a specific Asana story.

Parameters

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

AsanaApi.UpdateAsanaStory

Update an Asana story’s details.

Parameters

• mode (Enum ToolMode, required) Operation mode: ‘get_request_schema’ returns the OpenAPI spec for the request body, ‘execute’ performs the actual operation
• 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’

AsanaApi.DeleteAsanaStory

Delete a story you’ve created on Asana.

Parameters

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

AsanaApi.GetTaskStories

Retrieve all stories for a specified Asana task.

Parameters

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

AsanaApi.AddTaskComment

Add a comment to a specific task in Asana.

Parameters

• mode (Enum ToolMode, required) Operation mode: ‘get_request_schema’ returns the OpenAPI spec for the request body, ‘execute’ performs the actual operation
• 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’

AsanaApi.GetFilteredTags

Retrieve compact tag records with optional filters.

Parameters

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

AsanaApi.CreateNewAsanaTag

Create a new tag in an Asana workspace or organization.

Parameters

• mode (Enum ToolMode, required) Operation mode: ‘get_request_schema’ returns the OpenAPI spec for the request body, ‘execute’ performs the actual operation
• 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’

AsanaApi.GetAsanaTagDetails

Retrieve complete details for a specific Asana tag.

Parameters

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

AsanaApi.UpdateAsanaTag

Update properties of an Asana tag.

Parameters

• mode (Enum ToolMode, required) Operation mode: ‘get_request_schema’ returns the OpenAPI spec for the request body, ‘execute’ performs the actual operation
• 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’

AsanaApi.DeleteAsanaTag

Delete a specific tag in Asana with its unique ID.

Parameters

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

AsanaApi.GetTagsForTask

Retrieve all tags for a given task.

Parameters

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

AsanaApi.RetrieveWorkspaceTags

Retrieve tags for a specific workspace in Asana.

Parameters

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

AsanaApi.CreateWorkspaceTag

Create a new tag in a specific Asana workspace.

Parameters

• mode (Enum ToolMode, required) Operation mode: ‘get_request_schema’ returns the OpenAPI spec for the request body, ‘execute’ performs the actual operation
• 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’

AsanaApi.FetchProjectTaskTemplates

Retrieve compact task template records for a specific project.

Parameters

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

AsanaApi.FetchTaskTemplate

Retrieve the complete record of a specific task template in Asana.

Parameters

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

AsanaApi.DeleteTaskTemplate

Delete a specific task template by its ID.

Parameters

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

AsanaApi.CreateAsanaTask

Create and initiate an Asana task asynchronously.

Parameters

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

AsanaApi.GetFilteredTasks

Retrieve filtered task records from Asana.

Parameters

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

AsanaApi.AddAsanaTask

Create a new task in Asana.

Parameters

• mode (Enum ToolMode, required) Operation mode: ‘get_request_schema’ returns the OpenAPI spec for the request body, ‘execute’ performs the actual operation
• 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’

AsanaApi.GetTaskDetails

Fetch detailed information for a specific Asana task.

Parameters

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

AsanaApi.UpdateTask

Update specific fields of an existing Asana task.

Parameters

• mode (Enum ToolMode, required) Operation mode: ‘get_request_schema’ returns the OpenAPI spec for the request body, ‘execute’ performs the actual operation
• 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’

AsanaApi.DeleteAsanaTask

Delete an existing task in Asana, moving it to trash.

Parameters

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

AsanaApi.DuplicateAsanaTask

Create a job to duplicate a task in Asana.

Parameters

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

AsanaApi.GetProjectTasks

Fetch tasks from a specific Asana project.

Parameters

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

AsanaApi.GetTasksForSection

Fetch tasks for a specific section in Asana.

Parameters

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

AsanaApi.GetTasksForTag

Retrieve tasks associated with a specific tag in Asana.

Parameters

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

AsanaApi.GetUserTaskList

Retrieve tasks in a user’s My Tasks list.

Parameters

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

AsanaApi.GetTaskSubtasks

Retrieve subtasks for a specific task in Asana.

Parameters

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

AsanaApi.CreateSubtaskForTask

Create a new subtask under a specified parent task.

Parameters

• mode (Enum ToolMode, required) Operation mode: ‘get_request_schema’ returns the OpenAPI spec for the request body, ‘execute’ performs the actual operation
• 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’

AsanaApi.UpdateTaskParentAsana

Update the parent of an Asana task.

Parameters

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

AsanaApi.GetTaskDependencies

Retrieve all dependencies for a specific Asana task.

Parameters

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

AsanaApi.AddTaskDependencies

Add dependencies to an Asana task.

Parameters

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

AsanaApi.RemoveTaskDependencies

Unlink dependencies from a specified task on Asana.

Parameters

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

AsanaApi.GetTaskDependents

Retrieve the dependents of a specific task.

Parameters

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

AsanaApi.AddDependentsToTask

Add dependents to an Asana task.

Parameters

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

AsanaApi.RemoveTaskDependents

Unlink dependents from an Asana task.

Parameters

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

AsanaApi.AddTaskToProject

Add a task to a specified Asana project.

Parameters

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

AsanaApi.RemoveTaskFromProject

Remove a task from the specified project in Asana.

Parameters

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

AsanaApi.AddTagToTask

Add a tag to a specific Asana task.

Parameters

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

AsanaApi.RemoveTagFromTask

Remove a tag from a task in Asana.

Parameters

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

AsanaApi.AddFollowersToTask

Adds followers to an Asana task.

Parameters

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

AsanaApi.AsanaRemoveFollowerForTask

Remove followers from an Asana task.

Parameters

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

AsanaApi.RetrieveTaskByCustomId

Retrieve a task using a custom ID in Asana.

Parameters

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

AsanaApi.SearchTasksInWorkspace

Search for tasks in an Asana workspace using complex filters.

Parameters

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

AsanaApi.GetTeamMembership

Retrieve complete details for a team membership.

Parameters

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

AsanaApi.GetTeamMemberships

Retrieve compact team membership records from Asana.

Parameters

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

AsanaApi.FetchTeamMembers

Retrieve the team memberships for a given team in Asana.

Parameters

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

AsanaApi.GetUserTeamMemberships

Retrieve team membership records for a specific user.

Parameters

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

AsanaApi.AsanaCreateTeam

Create a team in your current Asana workspace.

Parameters

• mode (Enum ToolMode, required) Operation mode: ‘get_request_schema’ returns the OpenAPI spec for the request body, ‘execute’ performs the actual operation
• 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’

AsanaApi.GetAsanaTeamDetails

Retrieve detailed information for a specific Asana team.

Parameters

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

AsanaApi.UpdateTeamInWorkspace

Update a team within the current workspace.

Parameters

• mode (Enum ToolMode, required) Operation mode: ‘get_request_schema’ returns the OpenAPI spec for the request body, ‘execute’ performs the actual operation
• 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’

AsanaApi.GetAsanaTeamsForWorkspace

Retrieve all teams for a specified Asana workspace.

Parameters

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

AsanaApi.GetAsanaTeamsForUser

Get all teams assigned to a specific Asana user.

Parameters

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

AsanaApi.AddUserToTeam

Adds a user to a specified team on Asana.

Parameters

• 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).

AsanaApi.RemoveUserFromTeam

Removes a user from a specified Asana team.

Parameters

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

AsanaApi.GetTimePeriodRecord

Retrieve detailed information for a specific time period.

Parameters

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

AsanaApi.GetTimePeriods

Retrieve compact time period records from Asana.

Parameters

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

AsanaApi.GetTimeTrackingEntries

Retrieve time tracking entries for a specified task.

Parameters

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

AsanaApi.CreateTimeTrackingEntry

Create a time tracking entry on a task.

Parameters

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

AsanaApi.GetTimeTrackingEntry

Retrieve a time tracking entry from Asana.

Parameters

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

AsanaApi.UpdateTimeTrackingEntry

Updates an existing time tracking entry in Asana.

Parameters

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

AsanaApi.DeleteTimeTrackingEntry

Delete a specific time tracking entry in Asana.

Parameters

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

AsanaApi.FetchTimeTrackingData

Fetch time tracking entries from Asana.

Parameters

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

AsanaApi.WorkspaceTypeaheadSearch

Retrieve workspace objects using a typeahead search.

Parameters

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

AsanaApi.FetchUserTaskDetails

Retrieve the full record for a user task list.

Parameters

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

AsanaApi.FetchUserTasks

Fetch the full task list record for a user from Asana.

Parameters

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

AsanaApi.GetAsanaUsers

Retrieve Asana user records across workspaces.

Parameters

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

AsanaApi.GetUserDetails

Retrieve detailed user information from Asana.

Parameters

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

AsanaApi.GetUserFavorites

Retrieve a user’s favorites from a specified Asana workspace.

Parameters

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

AsanaApi.GetTeamUsersAsana

Retrieve user records for a specific Asana team.

Parameters

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

AsanaApi.GetWorkspaceUsers

Retrieve all users from a specified workspace.

Parameters

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

AsanaApi.GetAsanaWebhooks

Retrieve all registered Asana webhooks for a workspace.

Parameters

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

AsanaApi.CreateAsanaWebhook

Initiates the creation of a webhook in Asana.

Parameters

• mode (Enum ToolMode, required) Operation mode: ‘get_request_schema’ returns the OpenAPI spec for the request body, ‘execute’ performs the actual operation
• 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’

AsanaApi.RetrieveWebhookDetails

Retrieve the full record of a specified webhook.

Parameters

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

AsanaApi.AsanaUpdateWebhookFilters

Update filters for an Asana webhook.

Parameters

• mode (Enum ToolMode, required) Operation mode: ‘get_request_schema’ returns the OpenAPI spec for the request body, ‘execute’ performs the actual operation
• 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’

AsanaApi.DeleteAsanaWebhook

Permanently delete a webhook in Asana.

Parameters

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

AsanaApi.GetWorkspaceMembership

Get the complete record for a workspace membership.

Parameters

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

AsanaApi.GetUserWorkspaceMemberships

Fetches a user’s workspace membership records in Asana.

Parameters

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

AsanaApi.GetWorkspaceMemberships

Retrieve workspace membership records.

Parameters

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

AsanaApi.GetVisibleWorkspaces

Retrieve all workspaces visible to the user.

Parameters

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

AsanaApi.GetWorkspaceDetails

Retrieve detailed information about a specific Asana workspace.

Parameters

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

AsanaApi.UpdateWorkspaceName

Update the name of an existing Asana workspace.

Parameters

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

AsanaApi.AddUserToWorkspace

Add a user to an Asana workspace or organization.

Parameters

• 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).

AsanaApi.RemoveUserFromWorkspace

Remove a user from an Asana workspace or organization.

Parameters

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

AsanaApi.GetWorkspaceEvents

Retrieve all events in a workspace since a specific sync token.

Parameters

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

Reference

Below is a reference of enumerations used by some of the tools in the AsanaApi MCP Server:

ToolMode

• GET_REQUEST_SCHEMA: get_request_schema
• EXECUTE: execute

Auth

The AsanaApi MCP Server uses the Auth Provider with id arcade-asana to connect to users’ AsanaApi accounts. In order to use the MCP Server, you will need to configure the arcade-asana auth provider.

For detailed information on configuring the Asana OAuth provider with Arcade, see the Asana Auth Provider documentation.

pip install arcade_asana_api