Linear

Explore 5 actions and their permissionsExact inputs, sign-in scopes, access limits and approval rules.

With Linear, a hire can search issues, read one with its comments, open issues, comment, and move issues between states. There are two ways to connect it:

As each hireCopy Anchor Link

You make one Linear OAuth application for your workspace; Roster then acts as that application, and puts each hire's name and picture on what it creates. People see "Builder" on the comment, not you.

1. Make an OAuth application in LinearCopy Anchor Link

You need to be a Linear admin.

1. In Linear, open Settings → API → OAuth applications and click Create new.
2. Application name: Roster. Add a picture if you like.
3. Callback URLs: copy the address Roster shows on the Linear connection (it ends in /api/integrations/linear/oauth/callback) and paste it here.
4. Save, then copy the Client ID and Client secret.

2. Connect it in RosterCopy Anchor Link

1. Open Integrations → Tools, click Add a tool, then Linear.
2. Leave API key empty. Paste the OAuth app client ID and OAuth app client secret. Click Connect.
3. On the new connection, click Connect with Linear.

   

4. Linear asks you to authorise Roster for your Linear workspace. Click Authorize.

   Screenshot coming soonLinear's own authorise screen; capture by hand with a real Linear OAuth app.

5. Back in Roster, the connection says Connected with Linear: issues and comments now show each hire's name and picture.

What Roster asks Linear forCopy Anchor Link

It acts as the application (actor=app), so nothing it does uses your own account.

A personal API keyCopy Anchor Link

The quick way: everything hires do shows as you.

1. Open Linear's Security & access settings (the form in Roster links there too) and, under Personal API keys, click New API key.
2. Name it Roster. If Linear asks for permissions, choose Read, Write, Create issues and Create comments, and the teams hires work in.
3. Copy the key. It starts with lin_api_; Roster tells you at once if what you paste doesn't.
4. In Roster, open Integrations → Tools → Add a tool → Linear, paste it into API key and click Connect. Roster asks Linear who the key belongs to, and the connection shows Connected as your Linear workspace. If Linear refuses the key, Roster says so and saves nothing.

What each hire may doCopy Anchor Link

On the hire's Tools tab, add Linear (or click Change access on it) and choose:

• Teams: team keys like ENG, one per line. The hire can only see and change issues in these teams. Empty means every team the key or app can reach.
• What they can do: Read only (search and read) or Read and write (also create, comment and move).

A responsibility can also watch Linear: Roster checks for updated issues on its own, off the clock, and wakes the hire only when something changed.

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1
    }
  },
  "required": [
    "query"
  ]
}

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]+-\\d+$"
    }
  },
  "required": [
    "id"
  ]
}

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "team": {
      "type": "string",
      "minLength": 1,
      "description": "team key, e.g. ENG"
    },
    "title": {
      "type": "string",
      "minLength": 1
    },
    "description": {
      "default": "",
      "type": "string"
    }
  },
  "required": [
    "team",
    "title"
  ]
}

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]+-\\d+$"
    },
    "body": {
      "type": "string",
      "minLength": 1
    }
  },
  "required": [
    "id",
    "body"
  ]
}

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]+-\\d+$"
    },
    "state": {
      "type": "string",
      "minLength": 1
    }
  },
  "required": [
    "id",
    "state"
  ]
}