Asana
Arcade Optimized
Arcade tools designed for LLMs to interact with Asana
19tools
Arcade offers a toolkit for seamless interaction with Asana, enabling developers to automate project management tasks. The toolkit supports various functionalities tailored for managing tasks, tags, and projects efficiently.
Capabilities
- Create, update, and manage tasks and subtasks within Asana.
- Attach files to tasks in various formats.
- Retrieve detailed information about projects, teams, and users.
- List and create tags for organized task management.
- Mark tasks as completed to streamline workflows.
OAuth
- Provider: Asana
- Scopes: default
Secrets
- No secret types are utilized in this toolkit.
Available tools(19)
19 of 19
| Tool name | Description | Secrets | |
|---|---|---|---|
Attaches a file to an Asana task
Provide exactly one of file_content_str, file_content_base64, or file_content_url, never more
than one.
- Use file_content_str for text files (will be encoded using file_encoding)
- Use file_content_base64 for binary files like images, PDFs, etc.
- Use file_content_url if the file is hosted on an external URL | |||
Create a tag in Asana | |||
Creates a task in Asana
The task must be associated to at least one of the following: parent_task_id, project, or
workspace_id. If none of these are provided and the account has only one workspace, the task
will be associated to that workspace. If the account has multiple workspaces, an error will
be raised with a list of available workspaces. | |||
Get an Asana project by its ID | |||
Get the subtasks of a task | |||
Get an Asana tag by its ID | |||
Get a task by its ID | |||
Search for tasks | |||
Get an Asana team by its ID | |||
Get a user by ID | |||
Get an Asana workspace by its ID | |||
List projects in Asana | |||
List tags in an Asana workspace | |||
List teams in an Asana workspace | |||
List teams in Asana that the current user is a member of | |||
List users in Asana | |||
List workspaces in Asana that are visible to the authenticated user | |||
Mark a task in Asana as completed | |||
Updates a task in Asana |
Selected tools
No tools selected.
Click "Show all tools" to add tools.
Requirements
Select tools to see requirements
#
Asana.AttachFileToTask
Attaches a file to an Asana task Provide exactly one of file_content_str, file_content_base64, or file_content_url, never more than one. - Use file_content_str for text files (will be encoded using file_encoding) - Use file_content_base64 for binary files like images, PDFs, etc. - Use file_content_url if the file is hosted on an external URL
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
task_id | string | Required | The ID of the task to attach the file to. |
file_name | string | Required | The name of the file to attach with format extension. E.g. 'Image.png' or 'Report.pdf'. |
file_content_str | string | Optional | The string contents of the file to attach. Use this if the file is a text file. Defaults to None. |
file_content_base64 | string | Optional | The base64-encoded binary contents of the file. Use this for binary files like images or PDFs. Defaults to None. |
file_content_url | string | Optional | The URL of the file to attach. Use this if the file is hosted on an external URL. Defaults to None. |
file_encoding | string | Optional | The encoding of the file to attach. Only used with file_content_str. Defaults to 'utf-8'. |
Requirements
No secrets required
Output
Type:
json— The task with the file attached.#
Asana.CreateTag
Create a tag in Asana
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
name | string | Required | The name of the tag to create. Length must be between 1 and 100. |
description | string | Optional | The description of the tag to create. Defaults to None (no description). |
color | string | Optional | The color of the tag to create. Defaults to None (no color).dark-greendark-reddark-bluedark-purpledark-pinkdark-orangedark-tealdark-browndark-warm-graylight-greenlight-redlight-bluelight-purplelight-pinklight-orangelight-teallight-brownlight-warm-gray |
workspace_id | string | Optional | The ID of the workspace to create the tag in. If not provided, it will associated the tag to a current workspace, if there's only one. Otherwise, it will raise an error. |
Requirements
No secrets required
Output
Type:
json— The created tag.#
Asana.CreateTask
Creates a task in Asana The task must be associated to at least one of the following: parent_task_id, project, or workspace_id. If none of these are provided and the account has only one workspace, the task will be associated to that workspace. If the account has multiple workspaces, an error will be raised with a list of available workspaces.
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
name | string | Required | The name of the task |
start_date | string | Optional | The start date of the task in the format YYYY-MM-DD. Example: '2025-01-01'. Defaults to None. |
due_date | string | Optional | The due date of the task in the format YYYY-MM-DD. Example: '2025-01-01'. Defaults to None. |
description | string | Optional | The description of the task. Defaults to None. |
parent_task_id | string | Optional | The ID of the parent task. Defaults to None. |
workspace_id | string | Optional | The ID of the workspace to associate the task to. Defaults to None. |
project | string | Optional | The ID or name of the project to associate the task to. Defaults to None. |
assignee_id | string | Optional | The ID of the user to assign the task to. Defaults to 'me', which assigns the task to the current user. |
tags | array<string> | Optional | The tags to associate with the task. Multiple tags can be provided in the list. Each item in the list can be a tag name (e.g. 'My Tag') or a tag ID (e.g. '1234567890'). If a tag name does not exist, it will be automatically created with the new task. Defaults to None (no tags associated). |
Requirements
No secrets required
Output
Type:
json— Creates a task in Asana#
Asana.GetProjectById
Get an Asana project by its ID
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
project_id | string | Required | The ID of the project. |
Requirements
No secrets required
Output
Type:
json— Get a project by its ID#
Asana.GetSubtasksFromATask
Get the subtasks of a task
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
task_id | string | Required | The ID of the task to get the subtasks of. |
limit | integer | Optional | The maximum number of subtasks to return. Min of 1, max of 100. Defaults to 100. |
next_page_token | string | Optional | The token to retrieve the next page of subtasks. Defaults to None (start from the first page of subtasks) |
Requirements
No secrets required
Output
Type:
json— The subtasks of the task.#
Asana.GetTagById
Get an Asana tag by its ID
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
tag_id | string | Required | The ID of the Asana tag to get |
Requirements
No secrets required
Output
Type:
json— Get an Asana tag by its ID#
Asana.GetTaskById
Get a task by its ID
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
task_id | string | Required | The ID of the task to get. |
max_subtasks | integer | Optional | The maximum number of subtasks to return. Min of 0 (no subtasks), max of 100. Defaults to 100. |
Requirements
No secrets required
Output
Type:
json— The task with the given ID.#
Asana.GetTasksWithoutId
Search for tasks
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
keywords | string | Optional | Keywords to search for tasks. Matches against the task name and description. |
workspace_id | string | Optional | The workspace ID to search for tasks. Defaults to None. If not provided and the user has only one workspace, it will use that workspace. If not provided and the user has multiple workspaces, it will raise an error listing the available workspaces. |
assignee_id | string | Optional | The ID of the user to filter tasks assigned to. Defaults to None (does not filter by assignee). |
project | string | Optional | The ID or name of the project to filter tasks. Defaults to None (searches tasks associated to any project or no project). |
team_id | string | Optional | Restricts the search to tasks associated to the given team ID. Defaults to None (searches tasks associated to any team). |
tags | array<string> | Optional | Restricts the search to tasks associated to the given tags. Each item in the list can be a tag name (e.g. 'My Tag') or a tag ID (e.g. '1234567890'). Defaults to None (searches tasks associated to any tag or no tag). |
due_on | string | Optional | Match tasks that are due exactly on this date. Format: YYYY-MM-DD. Ex: '2025-01-01'. Defaults to None (searches tasks due on any date or without a due date). |
due_on_or_after | string | Optional | Match tasks that are due on OR AFTER this date. Format: YYYY-MM-DD. Ex: '2025-01-01' Defaults to None (searches tasks due on any date or without a due date). |
due_on_or_before | string | Optional | Match tasks that are due on OR BEFORE this date. Format: YYYY-MM-DD. Ex: '2025-01-01' Defaults to None (searches tasks due on any date or without a due date). |
start_on | string | Optional | Match tasks that started on this date. Format: YYYY-MM-DD. Ex: '2025-01-01'. Defaults to None (searches tasks started on any date or without a start date). |
start_on_or_after | string | Optional | Match tasks that started on OR AFTER this date. Format: YYYY-MM-DD. Ex: '2025-01-01' Defaults to None (searches tasks started on any date or without a start date). |
start_on_or_before | string | Optional | Match tasks that started on OR BEFORE this date. Format: YYYY-MM-DD. Ex: '2025-01-01' Defaults to None (searches tasks started on any date or without a start date). |
completed | boolean | Optional | Match tasks that are completed. Defaults to None (does not filter by completion status). |
limit | integer | Optional | The maximum number of tasks to return. Min of 1, max of 100. Defaults to 100. |
sort_by | string | Optional | The field to sort the tasks by. Defaults to TaskSortBy.MODIFIED_AT.due_datecreated_atcompleted_atmodified_atlikes |
sort_order | string | Optional | The order to sort the tasks by. Defaults to SortOrder.DESCENDING.ascendingdescending |
Requirements
No secrets required
Output
Type:
json— The tasks that match the query.#
Asana.GetTeamById
Get an Asana team by its ID
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
team_id | string | Required | The ID of the Asana team to get |
Requirements
No secrets required
Output
Type:
json— Get an Asana team by its ID#
Asana.GetUserById
Get a user by ID
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
user_id | string | Required | The user ID to get. |
Requirements
No secrets required
Output
Type:
json— The user information.#
Asana.GetWorkspaceById
Get an Asana workspace by its ID
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
workspace_id | string | Required | The ID of the Asana workspace to get |
Requirements
No secrets required
Output
Type:
json— Get an Asana workspace by its ID#
Asana.ListProjects
List projects in Asana
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
team_id | string | Optional | The team ID to get projects from. Defaults to None (does not filter by team). |
workspace_id | string | Optional | The workspace ID to get projects from. Defaults to None. If not provided and the user has only one workspace, it will use that workspace. If not provided and the user has multiple workspaces, it will raise an error listing the available workspaces. |
limit | integer | Optional | The maximum number of projects to return. Min is 1, max is 100. Defaults to 100. |
next_page_token | string | Optional | The token to retrieve the next page of projects. Defaults to None (start from the first page of projects). |
Requirements
No secrets required
Output
Type:
json— List projects in Asana associated to teams the current user is a member of#
Asana.ListTags
List tags in an Asana workspace
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
workspace_id | string | Optional | The workspace ID to retrieve tags from. Defaults to None. If not provided and the user has only one workspace, it will use that workspace. If not provided and the user has multiple workspaces, it will raise an error listing the available workspaces. |
limit | integer | Optional | The maximum number of tags to return. Min is 1, max is 100. Defaults to 100. |
next_page_token | string | Optional | The token to retrieve the next page of tags. Defaults to None (start from the first page of tags) |
Requirements
No secrets required
Output
Type:
json— List tags in an Asana workspace#
Asana.ListTeams
List teams in an Asana workspace
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
workspace_id | string | Optional | The workspace ID to list teams from. Defaults to None. If no workspace ID is provided, it will use the current user's workspace, if there's only one. If the user has multiple workspaces, it will raise an error listing the available workspaces. |
limit | integer | Optional | The maximum number of teams to return. Min is 1, max is 100. Defaults to 100. |
next_page_token | string | Optional | The token to retrieve the next page of teams. Defaults to None (start from the first page of teams) |
Requirements
No secrets required
Output
Type:
json— List teams in an Asana workspace#
Asana.ListTeamsTheCurrentUserIsAMemberOf
List teams in Asana that the current user is a member of
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
workspace_id | string | Optional | The workspace ID to list teams from. Defaults to None. If no workspace ID is provided, it will use the current user's workspace , if there's only one. If the user has multiple workspaces, it will raise an error. |
limit | integer | Optional | The maximum number of teams to return. Min is 1, max is 100. Defaults to 100. |
next_page_token | string | Optional | The token to retrieve the next page of teams. Defaults to None (start from the first page of teams) |
Requirements
No secrets required
Output
Type:
json— List teams in Asana that the current user is a member of#
Asana.ListUsers
List users in Asana
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
workspace_id | string | Optional | The workspace ID to list users from. Defaults to None. If no workspace ID is provided, it will use the current user's workspace , if there's only one. If the user has multiple workspaces, it will raise an error. |
limit | integer | Optional | The maximum number of users to retrieve. Min is 1, max is 100. Defaults to 100. |
next_page_token | string | Optional | The token to retrieve the next page of users. Defaults to None (start from the first page of users) |
Requirements
No secrets required
Output
Type:
json— List users in Asana#
Asana.ListWorkspaces
List workspaces in Asana that are visible to the authenticated user
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
limit | integer | Optional | The maximum number of workspaces to return. Min is 1, max is 100. Defaults to 100. |
next_page_token | string | Optional | The token to retrieve the next page of workspaces. Defaults to None (start from the first page of workspaces) |
Requirements
No secrets required
Output
Type:
json— List workspaces in Asana that are visible to the authenticated user#
Asana.MarkTaskAsCompleted
Mark a task in Asana as completed
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
task_id | string | Required | The ID of the task to mark as completed. |
Requirements
No secrets required
Output
Type:
json— The task marked as completed.#
Asana.UpdateTask
Updates a task in Asana
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
task_id | string | Required | The ID of the task to update. |
name | string | Optional | The new name of the task. Defaults to None (does not change the current name). |
completed | boolean | Optional | The new completion status of the task. Provide True to mark the task as completed, False to mark it as not completed. Defaults to None (does not change the current completion status). |
start_date | string | Optional | The new start date of the task in the format YYYY-MM-DD. Example: '2025-01-01'. Defaults to None (does not change the current start date). |
due_date | string | Optional | The new due date of the task in the format YYYY-MM-DD. Example: '2025-01-01'. Defaults to None (does not change the current due date). |
description | string | Optional | The new description of the task. Defaults to None (does not change the current description). |
assignee_id | string | Optional | The ID of the new user to assign the task to. Provide 'me' to assign the task to the current user. Defaults to None (does not change the current assignee). |
Requirements
No secrets required
Output
Type:
json— Updates a task in AsanaLast updated on