asana_search_tasks
Search and filter tasks in Asana workspaces using text, assignees, projects, tags, dates, custom fields, and advanced criteria to find specific work items.
Instructions
Search tasks in a workspace with advanced filtering options
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| assigned_by_any | No | Comma-separated list of user IDs | |
| assigned_by_not | No | Comma-separated list of user IDs to exclude | |
| assignee_any | No | Comma-separated list of user IDs | |
| assignee_not | No | Comma-separated list of user IDs to exclude | |
| commented_on_by_not | No | Comma-separated list of user IDs to exclude | |
| completed | No | Filter for completed tasks | |
| completed_at_after | No | ISO 8601 datetime string | |
| completed_at_before | No | ISO 8601 datetime string | |
| completed_on | No | ISO 8601 date string or null | |
| completed_on_after | No | ISO 8601 date string | |
| completed_on_before | No | ISO 8601 date string | |
| created_at_after | No | ISO 8601 datetime string | |
| created_at_before | No | ISO 8601 datetime string | |
| created_by_any | No | Comma-separated list of user IDs | |
| created_by_not | No | Comma-separated list of user IDs to exclude | |
| created_on | No | ISO 8601 date string or null | |
| created_on_after | No | ISO 8601 date string | |
| created_on_before | No | ISO 8601 date string | |
| 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" } | |
| due_at_after | No | ISO 8601 datetime string | |
| due_at_before | No | ISO 8601 datetime string | |
| due_on | No | ISO 8601 date string or null | |
| due_on_after | No | ISO 8601 date string | |
| due_on_before | No | ISO 8601 date string | |
| followers_not | No | Comma-separated list of user IDs to exclude | |
| 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 | |
| is_subtask | No | Filter for subtasks | |
| liked_by_not | No | Comma-separated list of user IDs to exclude | |
| modified_at_after | No | ISO 8601 datetime string | |
| modified_at_before | No | ISO 8601 datetime string | |
| modified_on | No | ISO 8601 date string or null | |
| modified_on_after | No | ISO 8601 date string | |
| modified_on_before | No | ISO 8601 date string | |
| opt_fields | No | Comma-separated list of optional fields to include | |
| portfolios_any | No | Comma-separated list of portfolio IDs | |
| projects_all | No | Comma-separated list of project IDs that must all match | |
| projects_any | No | Comma-separated list of project IDs | |
| projects_not | No | Comma-separated list of project IDs to exclude | |
| resource_subtype | No | Filter by task subtype (e.g. milestone) | |
| sections_all | No | Comma-separated list of section 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 | |
| sort_ascending | No | Sort in ascending order | |
| sort_by | No | Sort by: due_date, created_at, completed_at, likes, modified_at | modified_at |
| start_on | No | ISO 8601 date string or null | |
| start_on_after | No | ISO 8601 date string | |
| start_on_before | No | ISO 8601 date string | |
| tags_all | No | Comma-separated list of tag 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 | |
| teams_any | No | Comma-separated list of team IDs | |
| text | No | Text to search for in task names and descriptions | |
| workspace | Yes | The workspace to search in |
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",
"type": "string"
}
},
"required": [
"workspace"
],
"type": "object"
}