Linear

Connection

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

Minimum permissions the connection requires.

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

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.

When Klef adopts 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`

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

stage active {
  target linear.user {
    email  = worker.business_email
    role   = "user"
    active = true
  }
}