linear_integrations_settings (Resource)

Manages which events a Linear integration posts — the notification matrix behind an already-connected Slack or Microsoft Teams integration.

Connecting the integration itself is an OAuth flow and not something a provider can manage declaratively; this resource configures what an existing connection does. Attach it to exactly one of a team, project, initiative or custom view — all four are fixed at creation, since Linear's update mutation takes only the toggles.

#Example Usage

# Connecting Slack is an OAuth flow and not manageable declaratively; this is
# the layer above it — which events an existing connection posts.
resource "linear_integrations_settings" "engineering" {
  team_id = linear_team.engineering.id

  slack_issue_created             = true
  slack_issue_added_to_triage     = true
  slack_issue_status_changed_done = true
  slack_issue_sla_breached        = true
  slack_issue_new_comment         = false
}

#Schema

#Optional

• context_view_type (String) Which surface the settings apply to when attached to a project or initiative, e.g. project or initiative.
• custom_view_id (String) UUID of the linear_custom_view these settings belong to. Write-only: Linear does not report which view the settings belong to, so drift in this attribute cannot be detected.
• initiative_id (String) UUID of the initiative these settings belong to.
• microsoft_teams_project_update_created (Boolean) Post to Microsoft Teams when a project update is written.
• project_id (String) UUID of the project these settings belong to.
• slack_initiative_update_created (Boolean) Post to Slack when an initiative update is written.
• slack_issue_added_to_triage (Boolean) Post to Slack when an issue lands in triage.
• slack_issue_added_to_view (Boolean) Post to Slack when an issue enters the attached view.
• slack_issue_created (Boolean) Post to Slack when an issue is created.
• slack_issue_new_comment (Boolean) Post to Slack when an issue gets a comment.
• slack_issue_sla_breached (Boolean) Post to Slack when an issue breaches its SLA.
• slack_issue_sla_high_risk (Boolean) Post to Slack when an issue is at risk of breaching its SLA.
• slack_issue_status_changed_all (Boolean) Post to Slack on every issue status change.
• slack_issue_status_changed_done (Boolean) Post to Slack when an issue is completed. Redundant when slack_issue_status_changed_all is on.
• slack_project_update_created (Boolean) Post to Slack when a project update is written.
• slack_project_update_created_to_team (Boolean) Post project updates to the team's Slack channel.
• slack_project_update_created_to_workspace (Boolean) Post project updates to the workspace Slack channel.
• team_id (String) UUID of the team these settings belong to.

#Read-Only

• id (String) UUID of the integrations settings.

#Import

Import is supported using the following syntax:

The terraform import command can be used, for example:

# Import by UUID.
terraform import linear_integrations_settings.example a1b2c3d4-0000-0000-0000-000000000000