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

# List projects

> List projects visible in an Asana workspace or organization.

`listProjects` discovers project GIDs and metadata.

```ts automations/list-asana-projects.automation.ts theme={null}
import { automation, onHttpRequest } from "automate.ax"
import { listProjects } from "automate.ax/asana"

export default automation("List Asana projects", () => {
  onHttpRequest({ scope: "automation" })
  listProjects({ workspaceId: "workspace-gid", archived: false })
})
```

`workspaceId` is required. Optional `archived` controls whether archived projects are included. `limit` is 1–100 and defaults to `100`; `offset` continues pagination; `account` defaults to the project binding.

Returns `Signal<{ projects: AsanaProject[]; pageInfo: { nextOffset?: string } }>` with project dates, descriptions, visibility, team/workspace references, layout, URLs, and archive state.