asana_search_tasks
Search tasks in Asana workspaces using text queries and advanced filters for assignees, projects, due dates, custom fields, and completion status to find specific work items.
Instructions
Search tasks in a workspace with advanced filtering options
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| workspace | No | The workspace to search in (optional if DEFAULT_WORKSPACE_ID is set) | |
| text | No | Text to search for in task names and descriptions | |
| resource_subtype | No | Filter by task subtype (e.g. milestone) | |
| portfolios_any | No | Comma-separated list of portfolio IDs | |
| assignee_any | No | Comma-separated list of user IDs | |
| assignee_not | No | Comma-separated list of user IDs to exclude | |
| projects_any | No | Comma-separated list of project IDs | |
| projects_not | No | Comma-separated list of project IDs to exclude | |
| projects_all | No | Comma-separated list of project IDs that must all match | |
| sections_any | No | Comma-separated list of section IDs | |
| sections_not | No | Comma-separated list of section IDs to exclude | |
| sections_all | No | Comma-separated list of section IDs that must all match | |
| tags_any | No | Comma-separated list of tag IDs | |
| tags_not | No | Comma-separated list of tag IDs to exclude | |
| tags_all | No | Comma-separated list of tag IDs that must all match | |
| teams_any | No | Comma-separated list of team IDs | |
| followers_not | No | Comma-separated list of user IDs to exclude | |
| created_by_any | No | Comma-separated list of user IDs | |
| created_by_not | No | Comma-separated list of user IDs to exclude | |
| assigned_by_any | No | Comma-separated list of user IDs | |
| assigned_by_not | No | Comma-separated list of user IDs to exclude | |
| liked_by_not | No | Comma-separated list of user IDs to exclude | |
| commented_on_by_not | No | Comma-separated list of user IDs to exclude | |
| due_on | No | ISO 8601 date string or null | |
| due_on_before | No | ISO 8601 date string | |
| due_on_after | No | ISO 8601 date string | |
| due_at_before | No | ISO 8601 datetime string | |
| due_at_after | No | ISO 8601 datetime string | |
| start_on | No | ISO 8601 date string or null | |
| start_on_before | No | ISO 8601 date string | |
| start_on_after | No | ISO 8601 date string | |
| created_on | No | ISO 8601 date string or null | |
| created_on_before | No | ISO 8601 date string | |
| created_on_after | No | ISO 8601 date string | |
| created_at_before | No | ISO 8601 datetime string | |
| created_at_after | No | ISO 8601 datetime string | |
| completed_on | No | ISO 8601 date string or null | |
| completed_on_before | No | ISO 8601 date string | |
| completed_on_after | No | ISO 8601 date string | |
| completed_at_before | No | ISO 8601 datetime string | |
| completed_at_after | No | ISO 8601 datetime string | |
| modified_on | No | ISO 8601 date string or null | |
| modified_on_before | No | ISO 8601 date string | |
| modified_on_after | No | ISO 8601 date string | |
| modified_at_before | No | ISO 8601 datetime string | |
| modified_at_after | No | ISO 8601 datetime string | |
| completed | No | Filter for completed tasks | |
| is_subtask | No | Filter for subtasks | |
| has_attachment | No | Filter for tasks with attachments | |
| is_blocked | No | Filter for tasks with incomplete dependencies | |
| is_blocking | No | Filter for incomplete tasks with dependents | |
| sort_by | No | Sort by: due_date, created_at, completed_at, likes, modified_at | modified_at |
| sort_ascending | No | Sort in ascending order | |
| opt_fields | No | Comma-separated list of optional fields to include | |
| custom_fields | No | Object containing custom field filters. Keys should be in the format "{gid}.{operation}" where operation can be: - {gid}.is_set: Boolean - For all custom field types, check if value is set - {gid}.value: String|Number|String(enum_option_gid) - Direct value match for Text, Number or Enum fields - {gid}.starts_with: String - For Text fields only, check if value starts with string - {gid}.ends_with: String - For Text fields only, check if value ends with string - {gid}.contains: String - For Text fields only, check if value contains string - {gid}.less_than: Number - For Number fields only, check if value is less than number - {gid}.greater_than: Number - For Number fields only, check if value is greater than number Example: { "12345.value": "high", "67890.contains": "urgent" } |
Input Schema (JSON Schema)
{
"properties": {
"assigned_by_any": {
"description": "Comma-separated list of user IDs",
"type": "string"
},
"assigned_by_not": {
"description": "Comma-separated list of user IDs to exclude",
"type": "string"
},
"assignee_any": {
"description": "Comma-separated list of user IDs",
"type": "string"
},
"assignee_not": {
"description": "Comma-separated list of user IDs to exclude",
"type": "string"
},
"commented_on_by_not": {
"description": "Comma-separated list of user IDs to exclude",
"type": "string"
},
"completed": {
"description": "Filter for completed tasks",
"type": "boolean"
},
"completed_at_after": {
"description": "ISO 8601 datetime string",
"type": "string"
},
"completed_at_before": {
"description": "ISO 8601 datetime string",
"type": "string"
},
"completed_on": {
"description": "ISO 8601 date string or null",
"type": "string"
},
"completed_on_after": {
"description": "ISO 8601 date string",
"type": "string"
},
"completed_on_before": {
"description": "ISO 8601 date string",
"type": "string"
},
"created_at_after": {
"description": "ISO 8601 datetime string",
"type": "string"
},
"created_at_before": {
"description": "ISO 8601 datetime string",
"type": "string"
},
"created_by_any": {
"description": "Comma-separated list of user IDs",
"type": "string"
},
"created_by_not": {
"description": "Comma-separated list of user IDs to exclude",
"type": "string"
},
"created_on": {
"description": "ISO 8601 date string or null",
"type": "string"
},
"created_on_after": {
"description": "ISO 8601 date string",
"type": "string"
},
"created_on_before": {
"description": "ISO 8601 date string",
"type": "string"
},
"custom_fields": {
"description": "Object containing custom field filters. Keys should be in the format \"{gid}.{operation}\" where operation can be:\n- {gid}.is_set: Boolean - For all custom field types, check if value is set\n- {gid}.value: String|Number|String(enum_option_gid) - Direct value match for Text, Number or Enum fields\n- {gid}.starts_with: String - For Text fields only, check if value starts with string\n- {gid}.ends_with: String - For Text fields only, check if value ends with string\n- {gid}.contains: String - For Text fields only, check if value contains string\n- {gid}.less_than: Number - For Number fields only, check if value is less than number\n- {gid}.greater_than: Number - For Number fields only, check if value is greater than number\n\nExample: { \"12345.value\": \"high\", \"67890.contains\": \"urgent\" }",
"type": "object"
},
"due_at_after": {
"description": "ISO 8601 datetime string",
"type": "string"
},
"due_at_before": {
"description": "ISO 8601 datetime string",
"type": "string"
},
"due_on": {
"description": "ISO 8601 date string or null",
"type": "string"
},
"due_on_after": {
"description": "ISO 8601 date string",
"type": "string"
},
"due_on_before": {
"description": "ISO 8601 date string",
"type": "string"
},
"followers_not": {
"description": "Comma-separated list of user IDs to exclude",
"type": "string"
},
"has_attachment": {
"description": "Filter for tasks with attachments",
"type": "boolean"
},
"is_blocked": {
"description": "Filter for tasks with incomplete dependencies",
"type": "boolean"
},
"is_blocking": {
"description": "Filter for incomplete tasks with dependents",
"type": "boolean"
},
"is_subtask": {
"description": "Filter for subtasks",
"type": "boolean"
},
"liked_by_not": {
"description": "Comma-separated list of user IDs to exclude",
"type": "string"
},
"modified_at_after": {
"description": "ISO 8601 datetime string",
"type": "string"
},
"modified_at_before": {
"description": "ISO 8601 datetime string",
"type": "string"
},
"modified_on": {
"description": "ISO 8601 date string or null",
"type": "string"
},
"modified_on_after": {
"description": "ISO 8601 date string",
"type": "string"
},
"modified_on_before": {
"description": "ISO 8601 date string",
"type": "string"
},
"opt_fields": {
"description": "Comma-separated list of optional fields to include",
"type": "string"
},
"portfolios_any": {
"description": "Comma-separated list of portfolio IDs",
"type": "string"
},
"projects_all": {
"description": "Comma-separated list of project IDs that must all match",
"type": "string"
},
"projects_any": {
"description": "Comma-separated list of project IDs",
"type": "string"
},
"projects_not": {
"description": "Comma-separated list of project IDs to exclude",
"type": "string"
},
"resource_subtype": {
"description": "Filter by task subtype (e.g. milestone)",
"type": "string"
},
"sections_all": {
"description": "Comma-separated list of section IDs that must all match",
"type": "string"
},
"sections_any": {
"description": "Comma-separated list of section IDs",
"type": "string"
},
"sections_not": {
"description": "Comma-separated list of section IDs to exclude",
"type": "string"
},
"sort_ascending": {
"default": false,
"description": "Sort in ascending order",
"type": "boolean"
},
"sort_by": {
"default": "modified_at",
"description": "Sort by: due_date, created_at, completed_at, likes, modified_at",
"type": "string"
},
"start_on": {
"description": "ISO 8601 date string or null",
"type": "string"
},
"start_on_after": {
"description": "ISO 8601 date string",
"type": "string"
},
"start_on_before": {
"description": "ISO 8601 date string",
"type": "string"
},
"tags_all": {
"description": "Comma-separated list of tag IDs that must all match",
"type": "string"
},
"tags_any": {
"description": "Comma-separated list of tag IDs",
"type": "string"
},
"tags_not": {
"description": "Comma-separated list of tag IDs to exclude",
"type": "string"
},
"teams_any": {
"description": "Comma-separated list of team IDs",
"type": "string"
},
"text": {
"description": "Text to search for in task names and descriptions",
"type": "string"
},
"workspace": {
"description": "The workspace to search in (optional if DEFAULT_WORKSPACE_ID is set)",
"type": "string"
}
},
"required": [],
"type": "object"
}