List users

linear.listUsers discovers user IDs for assignments, delegation, subscriptions, project membership, and leads.

automations/find-linear-user.automation.ts

import { automation, onDashboardRun } from "automate.ax"
import { linear } from "automate.ax/linear"

export default automation("Find active Linear users", () => {
  onDashboardRun({ title: "Find active Linear users" })
  linear.listUsers({ active: true, name: "Ada", includeDisabled: false })
})

To find coding agents such as Codex, filter for app users and select a result whose supportsAgentSessions field is true:

const agents = linear.listUsers({ app: true, active: true })

Optional filters are exact email, a case-insensitive name substring, active, app, and includeDisabled. limit accepts 1–50 and defaults to 50. Other common page inputs are after and includeArchived. Second argument { account } defaults to the project binding. Returns { users: LinearUser[]; pageInfo: LinearPageInfo }. Each user reports whether it is an app identity and whether it supports agent sessions. includeDisabled controls the candidate set, while active filters it by active state.

Built-in triggers

Built-in actions

Runtime utilities

Integrations