Search tasks
Asana Search Tasks is a powerful AI-powered tool that enables advanced task searching in Asana workspaces. It supports multiple filters including text, date, status, user, project, tags, and custom fields for precise task retrieval.
Features
- Supports text search within task names and descriptions for targeted results.
- Filters tasks by completion status, subtasks, attachments, and dependency states.
- Enables filtering by assignees, followers, creators, and various user roles for personalized views.
- Offers complex queries including portfolio, project, section, and tag-based filters.
- Returns detailed task data with sortable fields and bulk operation capabilities for efficient management.
Benefits
- Enhances productivity by quickly locating relevant tasks within complex projects.
- Improves project tracking with comprehensive filtering options tailored to user roles and dates.
- Saves time through bulk task operations and refined search results.
- Supports better team collaboration by filtering tasks based on user involvement and dependencies.
- Optimizes workflow management by integrating custom fields and advanced sorting for task prioritization.
Description
Advanced task search with multiple filters. Supports text search, all date filters, status filters, user filters, project/portfolio/section/tag filters, and custom fields. Returns matching tasks with IDs. Handles complex queries and bulk task operations. When the user asks about tasks assigned to them, use assignee_any="me" for best results. Note: If you specify projects_any and sections_any, you will receive tasks for the project and tasks for the section. If you're looking for only tasks in a section, omit the projects_any from the request.
Parameters
58 parameters
| Name | Type | Description |
|---|---|---|
| workspacerequired | string | Globally unique identifier for the workspace. |
| text | string | Text to search for in task name or description. |
| resource_subtype | string | Filters results by the task's resource_subtype (e.g., milestone). |
| completed | boolean | Filter for completed or incomplete tasks. |
| is_subtask | boolean | Filter to subtasks. |
| has_attachment | boolean | Filter to tasks with attachments. |
| is_blocked | boolean | Filter to tasks with incomplete dependencies. |
| is_blocking | boolean | Filter to incomplete tasks with dependents. |
| assignee_any | string | Comma-separated list of user identifiers. |
| assignee_not | string | Comma-separated list of user identifiers to exclude. |
| followers_any | string | Comma-separated list of user identifiers. |
| followers_not | string | Comma-separated list of user identifiers to exclude. |
| created_by_any | string | Comma-separated list of user identifiers. |
| created_by_not | string | Comma-separated list of user identifiers to exclude. |
| assigned_by_any | string | Comma-separated list of user identifiers. |
| assigned_by_not | string | Comma-separated list of user identifiers to exclude. |
| liked_by_not | string | Comma-separated list of user identifiers to exclude. |
| commented_on_by_not | string | Comma-separated list of user identifiers to exclude. |
| portfolios_any | string | Comma-separated list of portfolio IDs. |
| projects_any | string | Comma-separated list of project IDs. |
| projects_not | string | Comma-separated list of project IDs to exclude. |
| projects_all | string | Comma-separated list of project IDs (tasks must be in all). |
| sections_any | string | Comma-separated list of section or column IDs. |
| sections_not | string | Comma-separated list of section or column IDs to exclude. |
| sections_all | string | Comma-separated list of section or column IDs (tasks must be in all). |
| tags_any | string | Comma-separated list of tag IDs. |
| tags_not | string | Comma-separated list of tag IDs to exclude. |
| tags_all | string | Comma-separated list of tag IDs (tasks must have all). |
| teams_any | string | Comma-separated list of team IDs. |
| due_on_before | string | ISO 8601 date string for due date before filter. |
| due_on_after | string | ISO 8601 date string for due date after filter. |
| due_on | string | ISO 8601 date string or null for due date. |
| due_at_before | string | ISO 8601 datetime string for due datetime before filter. |
| due_at_after | string | ISO 8601 datetime string for due datetime after filter. |
| start_on_before | string | ISO 8601 date string for start date before filter. |
| start_on_after | string | ISO 8601 date string for start date after filter. |
| start_on | string | ISO 8601 date string or null for start date. |
| created_on_before | string | ISO 8601 date string for creation date before filter. |
| created_on_after | string | ISO 8601 date string for creation date after filter. |
| created_on | string | ISO 8601 date string or null for creation date. |
| created_at_before | string | ISO 8601 datetime string for creation datetime before filter. |
| created_at_after | string | ISO 8601 datetime string for creation datetime after filter. |
| completed_on_before | string | ISO 8601 date string for completion date before filter. |
| completed_on_after | string | ISO 8601 date string for completion date after filter. |
| completed_on | string | ISO 8601 date string or null for completion date. |
| completed_at_before | string | ISO 8601 datetime string for completion datetime before filter. |
| completed_at_after | string | ISO 8601 datetime string for completion datetime after filter. |
| modified_on_before | string | ISO 8601 date string for modified date before filter. |
| modified_on_after | string | ISO 8601 date string for modified date after filter. |
| modified_on | string | ISO 8601 date string or null for modified date. |
| modified_at_before | string | ISO 8601 datetime string for modified datetime before filter. |
| modified_at_after | string | ISO 8601 datetime string for modified datetime after filter. |
| sort_by | string | Field to sort by (e.g., 'due_date', 'created_at', 'completed_at', 'likes', 'modified_at'). Defaults to modified_at. |
| sort_ascending | boolean | Sort in ascending order. Defaults to false. |
| opt_fields | string | Comma-separated list of optional fields to include in the response. |
| opt_pretty | boolean | Provides "pretty" output with line breaking and indentation. |
| custom_fields | string | JSON string of custom field filters in format: {"field_gid": "value"}. |
| limit | number | Number of results to return (1-100). |
