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

> List a cursor-paginated page of filtered Linear issues.

`listIssues` combines common ownership, planning, state, date, and text filters.

```ts automations/list-linear-issues.automation.ts theme={null}
import { automation, onHttpRequest } from "automate.ax"
import { listIssues } from "automate.ax/linear"

export default automation("Find recently updated Linear issues", () => {
  onHttpRequest({ scope: "automation" })
  listIssues({
    teamId: "team-uuid",
    updatedAtOrAfter: "2026-08-01T00:00:00Z",
    orderBy: "updatedAt",
    limit: 50,
  })
})
```

Optional filters are `assigneeId`, `createdAtOrAfter`, `labelId`, `parentId` (direct sub-issues), `projectId`, `search`, `stateId`, `teamId`, and `updatedAtOrAfter`. Timestamps require an ISO offset. `orderBy` is `"createdAt"` or `"updatedAt"` and defaults to `"updatedAt"`. Common page fields are `limit` (1–50, default 50), `after`, and `includeArchived`; optional `account` defaults to the project binding.

Returns `{ issues: LinearIssue[]; pageInfo: LinearPageInfo }`. Pass `endCursor` as `after` while `hasNextPage` is true.
