Linear

Project management API key Windmill docs

Create, update, search and triage Linear issues, comments, labels, projects and status updates from any Windmill script, flow or app.

Set up in 3 steps

1

Create an API key

At linear.app/settings/account/security, create a personal API key and copy it.

2

Add the resource in Windmill

Open Resources, add a resource of type linear, and paste the key.

3

Run your first script

Fork any script below and list your teams — most calls need a team id.

Scripts

Building blocks, if none of the projects above fit. Fork one, run it, or call it as a step inside your own flow.

Submit a script →

Trigger flows from Linear

Linear is not only a destination. These inbound paths are supported today.

New or updated issue (scheduled poll)

The New or Updated Issue trigger script polls Linear and returns the issues created or updated since its last run, optionally for one team. To run it, open a flow, add a trigger and choose Scheduled Poll, then pick the trigger script and an interval. The steps after it run once per new item, and each flow keeps its own cursor.

Resource type

The shape of the credential every script on this page expects.

FieldTypeRequiredWhat it is
apiKeystringYesA personal API key (lin_api_…) created under Settings → Security & access → Personal API keys (https://linear.app/settings/account/security).

Questions

What can the key do?

What the account that created it can, limited by the permissions and team access chosen for the key, and every action is attributed to that account.

Is my key stored on the hub?

Never. It lives only in your own Windmill workspace, encrypted at rest.