View as Markdown
Linear icon

Linear ACTION

List Workflow States

List workflow states (statuses) in Linear. Returns state IDs, names, types (e.g. backlog, started, completed, cancelled), and team info. Optionally filter by team. Uses OAuth authentication. See the documentation.
  • Action
  • Read only
  • OAuth
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Linear account once, then configure and run List Workflow States from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "linear-list-workflow-states",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    linear: { authProvisionId: "apn_xxxxxxx" },
    teamId: "Team",
    orderBy: "Order By",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

List Workflow States inputs
Property Type Description
teamId Team string
Optional team to filter workflow states by. If omitted, returns states across all teams the API key has access to. Use the Get Teams action to discover valid team IDs (UUID format, e.g. 4e80f53c-da9e-4dee-b14e-2cab3e2e8716).
Optional Dynamic
orderBy Order By string
By which field should the pagination order by. Available options are createdAt (default) and updatedAt.
Optional
first First integer
The number of workflow states to return
Optional
after After string
The cursor to return the next page of workflow states
Optional
includeArchived Include archived boolean
Should archived resources be included? (default: false)
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
linear-list-workflow-states
Version
0.0.1
App
Linear
Authentication
OAuth
Read-only
Yes
Destructive
No
Open world
Yes