From b83e12b77397706e437567e70f23483e93d95a5c Mon Sep 17 00:00:00 2001
From: Benson Mach <benson.mach@conductorone.com>
Date: Mon, 27 Jul 2026 22:11:14 +0000
Subject: [PATCH 1/3] docs(linear): correct the API key generation steps

Linear moved personal API keys out of the standalone API settings page
and under Security & access, and the key dialog is now a two-click
New API key -> Create flow.

Co-authored-by: c1-squire-dev[bot] <c1-squire-dev[bot]@users.noreply.github.com>
---
 baton/linear.mdx | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/baton/linear.mdx b/baton/linear.mdx
index cfec5ff4..f5dac350 100644
--- a/baton/linear.mdx
+++ b/baton/linear.mdx
@@ -34,10 +34,10 @@ Configuring the connector requires you to pass in credentials generated in Linea
 In Linear, click your profile photo and select **Settings**.
 </Step>
 <Step>
-Click **API**.
+In the **Quick search** box, enter `Security & access`, then select the **Security & access** page.
 </Step>
 <Step>
-In the **Personal API keys** section of the page, enter a label such as "C1" and click **Create key**.
+In the **Personal API keys** section of the page, click **New API key**. Enter a label such as "C1" and click **Create**.
 </Step>
 <Step>
 The new API key is generated for you. Carefully copy and save the API key.

From bfb5c83ba76ed2d47621066fd531323cb8d0da9b Mon Sep 17 00:00:00 2001
From: Melinda Moreland <mindy.moreland@conductorone.com>
Date: Thu, 30 Jul 2026 14:23:32 -0700
Subject: [PATCH 2/3] docs: fix Linear API key creation step to include
 permissions/team access

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
---
 baton/linear.mdx | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/baton/linear.mdx b/baton/linear.mdx
index f5dac350..ff018cf6 100644
--- a/baton/linear.mdx
+++ b/baton/linear.mdx
@@ -37,7 +37,7 @@ In Linear, click your profile photo and select **Settings**.
 In the **Quick search** box, enter `Security & access`, then select the **Security & access** page.
 </Step>
 <Step>
-In the **Personal API keys** section of the page, click **New API key**. Enter a label such as "C1" and click **Create**.
+In the **Personal API keys** section of the page, click **New API key**. Enter a label such as "C1", configure the key's permissions and team access, and click **Create**.
 </Step>
 <Step>
 The new API key is generated for you. Carefully copy and save the API key.

From 1297bcd8f4a609ae52607e62d8ef2bb91a68193b Mon Sep 17 00:00:00 2001
From: Melinda Moreland <mindy.moreland@conductorone.com>
Date: Thu, 30 Jul 2026 14:24:51 -0700
Subject: [PATCH 3/3] docs: align MCP server Linear API key steps with
 corrected UI flow

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
---
 product/admin/mcp-server/linear.mdx | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/product/admin/mcp-server/linear.mdx b/product/admin/mcp-server/linear.mdx
index 54ffa1d6..3dc4dbcb 100644
--- a/product/admin/mcp-server/linear.mdx
+++ b/product/admin/mcp-server/linear.mdx
@@ -93,10 +93,10 @@ Create a personal API key in Linear for the account C1 should run as. For Linear
 Sign in to Linear as the account C1 should run as, then open **Settings** > **Security & access**.
 </Step>
 <Step>
-Under **Personal API keys**, select **Create key**.
+Under **Personal API keys**, select **New API key**.
 </Step>
 <Step>
-Enter a label such as `C1` and select **Create**.
+Enter a label such as `C1`, configure the key's permissions and team access, and select **Create**.
 </Step>
 <Step>
 Copy the key immediately. Linear shows it only once.