List workflow states

listWorkflowStates discovers state IDs for issue creation and movement.

automations/list-linear-states.automation.ts

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

export default automation("List Linear workflow states", () => {
  onHttpRequest({ scope: "automation" })
  listWorkflowStates({ teamId: "team-uuid" })
})

Optional teamId restricts states to one team. Common page inputs are limit (1–50, default 50), after, and includeArchived; account defaults to the project binding. Returns { workflowStates: LinearWorkflowState[]; pageInfo: LinearPageInfo }; states include ID, name, category type, color, description, ordering position, owning team, and dates.

⌘I

Get started

Concepts

Reference