Linear

When you connect a Linear workspace to Oblique, Oblique will automatically sync the workspace’s members and teams.

As you add people to Linear, move them between teams, or remove their access, these changes are automatically synced to Oblique.

You can add multiple Linear workspaces to Oblique. These function as separate integrations and are distinguished by their workspace name.

Supported options

Oblique integrates with Linear:

• As a source for accounts
• As a source for resources

From your Linear workspace, Oblique syncs:

• Members of the Linear workspace, as Oblique accounts
• Your Linear workspace and its teams, as Oblique resources
• Each member’s workspace and team memberships, as Oblique entitlements

Linear accounts are automatically matched to Oblique users based on email.

Note

Oblique imports accounts for members in your Linear workspace, including guests. Oblique does not import suspended members (who can no longer access the workspace) or accounts for connected applications or agents.

Caution

Oblique’s Linear integration is currently read-only. Oblique cannot make changes to your Linear workspace members, teams, or team members.

Supported resources

• Linear workspace
• Linear teams

A Linear integration has at least one resource for the workspace you connected, plus resources for each team in that workspace.

Teams in Linear can have sub-teams. Oblique reads each team’s membership as Linear reports it, and doesn’t infer membership of a parent team from membership of one of its sub-teams. Linear requires a sub-team’s members to also be members of its parent team, except for guests, who can belong to a sub-team without belonging to its parent.

Supported roles

The Oblique Linear integration supports information on Linear roles, which are defined in Linear. Every entitlement from Linear corresponds to exactly one role on a resource. The available roles depend on the type of resource. Certain roles may only be available on certain Linear pricing plans.

A workspace membership carries one of these roles:

• Workspace owner
• Admin
• Member
• Guest

A team membership carries one of these roles:

• Team owner
• Member

Caution

On Linear’s Free plan, every member of the workspace is an administrator, so every account holds the Admin role on the workspace in Oblique.

Required permissions

The Oblique Linear integration requests the read scope for your Linear workspace, which grants read access to the workspace, including its members and teams.

Caution

Oblique can only import private Linear teams if connected using an admin account who can see their existence and membership. Connect the Oblique Linear integration using a workspace admin’s or owner’s account.

Add Linear integration

You must be an admin to add an integration.

You connect a Linear workspace to Oblique by signing in to Linear and approving the access Oblique asks for.

To add a Linear integration, navigate to the Integrations page:

1. Select Add integration.
2. Select Linear.
3. Select Connect Linear.
4. Sign in to Linear, select the workspace to connect, and approve the access Oblique asks for.

Oblique will immediately start syncing the workspace’s members and teams.

Change Linear integration’s authorizations

You must be an admin to change an integration's authorizations.

To reconnect the Oblique Linear integration, including to change the member it is tied to, from the integration’s detail page:

1. Navigate to the Settings tab.
2. Under Connection, select Reconnect.
3. Sign in as a different Linear member and approve the access Oblique asks for.

You can only reconnect the current workspace. To change the workspace, instead delete the integration and add another one.

Manage entitlements

The Oblique Linear integration is currently read-only, so cannot be used to manage your Linear workspace’s members, teams, or team members.

Sync Linear integration

You don’t need to do anything to sync the Linear integration. Oblique will automatically and continuously sync changes from Linear.

Remove Linear integration

You must be an admin to remove an integration.

To remove a Linear integration, from the integration’s detail page:

1. Navigate to the Settings tab.
2. At the bottom of the page, under Delete integration, select Delete integration….
3. In the confirmation dialog, type the text to confirm, then select Delete integration.

This will immediately stop all syncing and remove all resources from the integration.

Caution

Removing the integration doesn’t revoke Oblique’s access to Linear. To revoke it, in Linear navigate to Settings > Administration > API and remove Oblique.

Remove an integration