> ## Documentation Index
> Fetch the complete documentation index at: https://klef.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Linear

<div className="page-title-row">
  <img src="https://mintcdn.com/klef/xJ0kXbcegZOD2G3h/images/connectors/linear.svg?fit=max&auto=format&n=xJ0kXbcegZOD2G3h&q=85&s=54ef7fdedbc5c8dc61466fdaedb1e5d0" alt="" noZoom width="24" height="24" data-path="images/connectors/linear.svg" />

  <h1>Linear</h1>
</div>

## Connection

Connecting sends you to Linear to approve Klef's access.

### Permissions

Minimum permissions the connection requires.

| Capability     | Required | Granted by (any one)       |
| -------------- | -------- | -------------------------- |
| Manage members | Yes      | `admin`, `Workspace admin` |
| Read teams     | Yes      | `read`                     |

## linear.user

### Fields

| Field     | Type   | Required | Description                                                                                                  |
| --------- | ------ | -------- | ------------------------------------------------------------------------------------------------------------ |
| `email`   | string | Yes      | Email address the invite goes to and the member signs in with. Klef does not change it.                      |
| `name`    | string |          | Full name. Set once the member has accepted their invite.                                                    |
| `title`   | string |          | Job title. Set once the member has accepted their invite.                                                    |
| `role`    | enum   |          | Workspace role. Defaults to member. Values: `user` (Member), `admin` (Admin), `guest` (Guest).               |
| `teams`   | grant  |          | Teams the member belongs to. One row grants one team.                                                        |
| `teams[]` | string |          | Team ID.                                                                                                     |
| `active`  | bool   |          | Whether the member can sign in. Switching it off suspends a member, or withdraws an invite not yet accepted. |

### Default Account Matching Rules

When Klef [adopts](/docs/adoption) an account that already exists in Linear, it works out whose it is by trying these in order. A connection can override them.

| Account field | Worker field            |
| ------------- | ----------------------- |
| `email`       | `worker.business_email` |

## Examples

### Linear members

A Linear invite for every engineer, suspended when they go, or withdrawn if never accepted.

```hcl theme={null}
stage active {
  target linear.user {
    email  = worker.business_email
    role   = "user"
    active = true
  }
}
```