Skip to the operations

Productivity

Linear in a decision flow.

8 Linear operations a decision flow can call directly, with the credentials your own contract issued. The response is data the rest of the flow reads, branches on, and keeps in the trace.

Category
Productivity
Type
Integration
Authentication
API key or OAuth 2.0
Test environment
Production host only

Who they are

Issue tracking and product planning for software teams.

Linear is an issue tracker and product-planning system built around teams, projects and cycles. Software teams use it to turn product decisions and customer reports into assigned work, then follow that work through a defined workflow. Its API is GraphQL, and access can act as either a personal API-key owner or the user who approved an OAuth application.

What a flow can call

8 operations, each one a step you can place on the canvas.

  1. POST/

    Verify connection

    Returns the Linear user who owns this API key or authorized the OAuth connection.

  2. POST/

    Create an issue

    Set data.linear_issue_create to an object with an input property.

  3. POST/

    Get an issue

    Set data.linear_issue_lookup to { issueId } using a Linear UUID or identifier such as ENG-123.

  4. POST/

    List issues

    Returns the first 50 issues visible to the connection.

  5. POST/

    Update an issue

    Set data.linear_issue_update to { issueId, input }.

  6. POST/

    Delete an issue

    Set data.linear_issue_delete to { issueId }. This permanently deletes the selected Linear issue.

  7. POST/

    Add a link to an issue

    Set data.linear_issue_link to { issueId, url }. Linear adds the URL as an issue attachment.

  8. POST/

    Add a comment or reply

    Set data.linear_comment to { input }, where input contains issueId and body.

Where it sits in the decision

Productivity calls have a natural place in a flow.

Operational work begins where the decision ends. Creating an issue, adding its evidence and keeping its state current from the flow gives the team one durable record of what was decided and what must happen next, without a second copy drifting in a handoff.

Whatever Linear returns is part of the run, so it is part of the record. When someone asks months later why an applicant was declined, the answer cites what came back at the time rather than re-fetching from a service whose answer has since changed.

  • 01Add Linear as a connection authenticating with an API key or OAuth 2.0.
  • 02Linear has one host for both environments, so guard test runs with your own credentials and limits.
  • 03Place a Connection node and pick an operation — “Verify connection” is usually the first one a flow needs.
  • 04Map the response into the fields your rules read, then test the whole path before it carries live traffic.

Common questions

Using Linear in a flow.

How do I connect Linear to a decision flow?

Add Linear as a connection in your workspace authenticating with an API key or OAuth 2.0, with the credentials your own contract issued — ArboRule calls the provider as you, and never holds a contract on your behalf. Once the connection exists, any flow in the workspace can place a Connection node and choose one of its operations. The credentials live on the connection, not in the flow, so a policy owner can use Linear in a decision without ever seeing the secret.

Can I test Linear without touching production?

Linear exposes one host for both environments, so there is no separate sandbox to point at. Test runs still execute in Sandbox and are recorded separately in decision history, but the call goes to the same place as production — so guard it with your own test credentials, rate limits, or data.

What can a flow call on Linear?

8 operations, including “Verify connection”, “Create an issue”, “Get an issue”. Each one is a step you place on the canvas and map into the fields your rules read, and most flows start with “Verify connection”. The list comes from the same manifest the engine uses to make the call, so this page cannot describe an operation the product does not have.

Where in a decision should Linear be called?

Operational work begins where the decision ends. Creating an issue, adding its evidence and keeping its state current from the flow gives the team one durable record of what was decided and what must happen next, without a second copy drifting in a handoff.

Ready when you are

Wire Linear into a real decision.

Build the flow in Sandbox, connect your account, and watch the decision pull what it needs before it answers.

Read the docs