Skip to main content

Linear

Visualize your Linear organization, projects, teams, and users in the JupiterOne graph and monitor changes to Linear entities by leveraging JupiterOne alerts.

Installation​

The integration connects to Linear's GraphQL API using a personal API key to ingest your Linear organization, teams, projects, users, and issues into JupiterOne.

info

Before you begin, you will need a Linear personal API key. In Linear, admins choose whether members can create their own API keys from Settings > Administration > API > Member API keys. Admins and permitted members can then create personal API keys. For more information, see Linear's API documentation.

Prerequisites​

  • A Linear personal API key created by a user who is permitted to create one.
  • The key must be granted at least the Read permission.
  • The key's access must cover the team or teams whose data you want to ingest. Ingested data is bounded by the key owner's own Linear permissions and team access.

Configuration in Linear​

  1. In Linear, go to Settings > Account > Security & Access (or visit linear.app/settings/account/security).
  2. Create a personal API key. When creating the key, grant it at least the Read permission, and limit its team access to the teams whose data you want JupiterOne to ingest.
  3. Copy the API key and save it for use within JupiterOne.

Configuration in JupiterOne​

To install the Linear integration in JupiterOne, navigate to the Integrations tab in JupiterOne and select Linear. Click New Instance to begin configuring your integration.

Creating an instance requires the following:

  • The Account Name used to identify the Linear account in JupiterOne. Ingested entities will have this value stored in tag.AccountName when the Tag with Account Name toggle is enabled.

  • A Description to assist in identifying the integration instance, if desired.

  • A Polling Interval that you feel is sufficient for your monitoring needs. You may leave this as DISABLED and manually execute the integration.

  • The Access Token field, in which you enter the Linear personal API key you created.

Click Create once all values are provided to finalize the integration.

Next steps​

Now that your integration instance has been configured, it will begin running on the polling interval you provided, populating data about your Linear environment within JupiterOne. Continue on to our Instance management guide to learn more about working with and editing integration instances.