OAuth 2.0 Authentication

How to quickly get a Linear OAuth2 application set up.

It is recommended you create a workspace for the purpose of managing the OAuth2 Application, as each admin user will have access.

Create an OAuth2 application in Linear

Create a new OAuth2 Application

Configure the redirect callback and redirect URLs

1. Add any Application name, Developer name.

2. Add https://controller-frontend.vercel.app/ as the Developer URL

3. Add https://controller-frontend.vercel.app/api/oauth2/callback as the Callback URL

4. Click the big blue Create button

It should look something like this

Import client details

Copy the Client ID and Client Secret. Paste these into the corresponding fields in Controller.

Hit Login with Linear. Done!

Using Linear

The following types of commands are supported (for now). Drop us a message if you need something else!

Create an issue

You can create a Linear issue and specify the relevant fields.

Create an issue titled Talk to Users and assign it to Aaron Tan

Get issues

You can retrieve Linear issues by specifying the relevant filter conditions.

Get me all issues assigned to Aaron Tan that are in progress

Update an issue

You can update a Linear issue by specifying the relevant filter conditions and updated values.

Assign the label "Launch" to all the issues assigned to Aaron Tan

Delete an issue

You can delete a Linear issue by specifying the relevant filter conditions.

Delete all issues assigned to Aaron Tan

Linear Gotchas

Referencing names