Skip to content

Warning

You're viewing an older version of this GitHub Action. Do you want to see the latest version instead?

Find or Create Linear Issue and Prefix PR

Actions
Ensure s every Pull Request has a Linear Issue associated with it and is displayed prominently in the title
v0.60
Star (4)

action-find-or-create-linear-issue

This is a Github Action that finds or creates a Linear Issue for your Pull Request. The Linear Issue identifier (e.g. ENG-123) is prefixed to the title of the PR.

This is helpful when you're:

  • Ensuring each Pull Request has a Linear Issue.

Inputs

Input Description Required
github-token GitHub token required to modify the PR title.
linear-api-key Linear API key generated from https://linear.app/settings/api . (e.g. lin_api_*)
linear-team-key Team key (e.g. ENG) for the created Linear issue.

Outputs

Output Description
linear-issue-id The Linear issue's unique identifier. (UUID)
linear-issue-identifier The Linear issue's human readable identifier. (e.g. ENG-123)
linear-issue-number The Linear issue's number. (e.g. the 123 of ENG-123)
linear-issue-title The Linear issue's title.
linear-issue-description The Linear issue's description.
linear-issue-url The Linear issue's URL. (e.g. https://...)
linear-team-id The Linear teams unique identifier. (UUID)
linear-team-key The Linear teams key/prefix (e.g. ENG)
did-create true if a Linear issue was created using this action.

Example usage

Create Linear Issue on Pull Request

name: Find or Create Linear Issue in Pull Request

on:
  workflow_dispatch:
  pull_request:
    branches:
      - main
    types: ["opened", "edited", "reopened", "synchronize"]

permissions:
  pull-requests: write

jobs:
  create-linear-issue-on-pull-request:
    runs-on: ubuntu-latest
    steps:
      - name: Find or create a Linear Issue
        uses: ctriolo/action-find-or-create-linear-issue@v1
        with:
          github-token: ${{secrets.GITHUB-TOKEN}}
          linear-api-key: ${{secrets.LINEAR_API_KEY}}
          linear-team-key: "ENG"

Find or Create Linear Issue and Prefix PR is not certified by GitHub. It is provided by a third-party and is governed by separate terms of service, privacy policy, and support documentation.

About

Ensure s every Pull Request has a Linear Issue associated with it and is displayed prominently in the title
v0.60

Find or Create Linear Issue and Prefix PR is not certified by GitHub. It is provided by a third-party and is governed by separate terms of service, privacy policy, and support documentation.