Linear

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

As you add people to Linear, change their role, move them between teams, remove their access, or add and delete teams, 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 syncs the following from your Linear workspace.

Linear object	Oblique object	Capability
Members	Accounts	Read-only
Workspace	Resources	Read-only
Teams	Resources	Read-only
Roles	Roles	Read-only
Workspace membership	Entitlements	Read-only
Team membership	Entitlements	Read-only

Accounts

Oblique syncs each Linear member as an Oblique account. Members who are guests are included. Members who are suspended, whose active is false, and connected applications and agents, whose app is true, aren’t synced.

Linear accounts are matched to Oblique users by email.

Account matching

Resources

Oblique’s Linear integration is read-only. Oblique can’t make changes to your Linear workspace, its members and teams, or their roles.

Oblique syncs the following from Linear as resources:

• The Linear workspace you connected
• Each team in the workspace

Every account has an entitlement for the workspace.

Sub-teams

In Linear, a team can have 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. Oblique doesn’t infer membership of a parent team from membership of one of its sub-teams, but instead reads the team members as reported by Linear.

Roles

Oblique syncs Linear roles as Oblique roles, for both workspace and team memberships. Certain roles may only be available on certain Linear pricing plans.

Every entitlement from Linear is for exactly one role.

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 Linear integration should be connected by a Linear workspace admin or owner, and requests the following permissions for your Linear workspace:

• Read the workspace, including its members and teams

Caution

Although you can connect the Linear integration with another account, Oblique can only import private Linear teams if connected by an admin or owner who can see their existence and membership.

Add Linear integration

You must be an admin to add an integration.

You connect a Linear workspace to Oblique by signing in to Linear as a workspace admin or owner 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 as a workspace admin or owner, 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 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

Oblique’s Linear integration is read-only, so it can’t be used to manage your Linear workspace, its members and teams, or their roles. Make these changes in Linear directly, and Oblique will sync them automatically.

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.