> ## 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.

# Asana

> Manage Asana workspaces, projects, sections, tasks, and comments from TypeScript automations.

Import actions and triggers from `automate.ax/asana`. Actions accept plain values or compatible signals. Asana triggers watch one statically selected resource GID and return normalized event signals.

```ts theme={null}
import { automation } from "automate.ax"
import { addTaskComment, onAsanaTaskCompleted } from "automate.ax/asana"

export default automation("Celebrate completed tasks", () => {
  const event = onAsanaTaskCompleted({ resourceId: "project-gid" })
  addTaskComment({ taskId: event.resource.id, text: "Completed!" })
})
```

## Accounts and identifiers

Leave `account` unset to use the project's default Asana binding, or pass a name or `asanaAccount(...)` reference. Trigger account selection must be static. See [Integration accounts](/concepts/integration-accounts).

Asana actions use stable globally unique identifiers (GIDs), exposed as `id` in normalized outputs. List actions return one page and an optional `pageInfo.nextOffset`; pass that value back as `offset` for the next page.

## Common outputs

All resources include `id` and optional `name` and `type`. Task outputs also include assignment and completion state, timestamps, descriptions, custom fields, dates, followers, memberships, projects, tags, parent, subtype, workspace, and permalink. Provider timestamps remain RFC 3339 strings.

<CardGroup cols={2}>
  <Card title="Tasks" href="/reference/integrations/asana/actions/create-task">
    Create, find, assign, place, and complete tasks.
  </Card>

  <Card title="Projects and sections" href="/reference/integrations/asana/actions/list-projects">
    Manage project structure and ordering.
  </Card>

  <Card title="Stories" href="/reference/integrations/asana/actions/list-task-stories">
    Read and manage task comments and activity.
  </Card>

  <Card title="Events" href="/reference/integrations/asana/triggers/on-asana-event">
    Watch raw or semantic resource changes.
  </Card>
</CardGroup>
