> ## Documentation Index
> Fetch the complete documentation index at: https://docs.automate.ax/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Automate.ax automations are TypeScript programs.
> Use Bun for installation and command examples.
> Use Automate.ax for the product name and automate.ax for the package, CLI, and domain.
> Treat documented public APIs as current; do not invent transitional or deprecated names.

# Search tasks

> Search tasks across a premium Asana workspace.

`searchTasks` uses Asana advanced search for text, ownership, state, dates, projects, and sections.

```ts automations/search-asana-tasks.automation.ts theme={null}
import { automation, onHttpRequest } from "automate.ax"
import { searchTasks } from "automate.ax/asana"

export default automation("Find overdue launch work", () => {
  onHttpRequest({ scope: "automation" })
  searchTasks({
    workspaceId: "workspace-gid",
    text: "launch",
    completed: false,
    dueBefore: "2026-09-01",
    sortBy: "due_date",
  })
})
```

`workspaceId` is required. Optional filters are `assignee` (user GID, `"me"`, or `null` for unassigned), `completed`, `createdAfter`, `dueAfter`, `dueBefore`, `modifiedAfter`, `projectIds`, `sectionIds`, and `text`. `sortBy` accepts `"completed_at"`, `"created_at"`, `"due_date"`, `"likes"`, or `"modified_at"`; `sortAscending` sets direction. `limit` is 1–100 and defaults to `100`; optional `account` defaults to the project binding.

Returns `Signal<{ tasks: AsanaTask[] }>`. Asana advanced search requires an eligible paid workspace and does not expose cursor pagination here.
