> Index of every Falcon docs page, for assistants: https://falcon.com/docs/llms.txt

# Linear

Read Linear teams, issues, comments and projects, create and update issues, add a comment, and start a workflow when an issue or comment changes.

## What it can do

- Read: **Get the signed-in user**, **List teams**, **Get a team**, **List a team's issues**, **List workflow states**, **Get a workflow state**, **Search issues**, **Get an issue**, **List issues assigned to a person**, **List comments on an issue**, **List projects**, **Get a project**, **List workspace members** and **Get a workspace member**.
- Change: **Create an issue**, **Update an issue** and **Add a comment**.

You send the values for a fixed question. You do not send your own question. A page is at most 50 rows, not the whole workspace. This app does not create or update projects, edit a comment, or archive. A sign-in lasts 24 hours and is refreshed for you.

## What can start a workflow

- **Issue create**, **Comment create**, **Issue update**, **Comment update**, **Issue remove** and **Comment remove**.
- A comment is kept only when it belongs to the team this connection is watching. Studio checks the signature, then reads the issue when the comment does not name a team.
- This app cannot create that subscription itself, because that needs an admin permission it does not ask for. The subscription is on the Linear application.

## How to connect

Open **Connections**, then **Apps**. In the **Apps** heading, search with **Search apps to add** and choose **Add** on Linear.

When the panel offers **Who signs in**, pick **Sign in as the company (one account for every agent)** or **Each person signs in to their own account when first needed**.

Read what it asks for. If it has not said, the panel says **You'll see what Linear asks for on its own sign-in page.** Choose **Continue to Linear** and finish there. Do not paste a password into Studio. When it works, the row says **Connected**.

If it says **This app can't be connected here yet: it needs a sign-in setup this server doesn't have.** or **Connecting Linear opens soon on this server.**, this server cannot sign Linear in yet. If you do not see **Add**, ask an admin to add Linear.

## What it asks for

- Read teams, issues, comments, projects and people (`read`).
- Create and update issues (`issues:create`).
- Add a comment (`comments:create`).
- It does not ask for `write` or `admin`.

## Related

- [Jira](https://falcon.com/docs/app-jira)
- [Asana](https://falcon.com/docs/app-asana)
- [Connections](https://falcon.com/docs/connections)