From 564e556f4580b2971fbc94014f9cdf782257de86 Mon Sep 17 00:00:00 2001 From: "codegen-sh[bot]" <131295404+codegen-sh[bot]@users.noreply.github.com> Date: Fri, 12 Sep 2025 20:18:54 +0000 Subject: [PATCH 1/2] docs: add requirement for user-installed apps in Jira integration MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Add a new step to the Jira integration setup guide specifying that user-installed apps must be enabled in the Jira workspace. This is a prerequisite for the Codegen integration to work properly. Changes: - Added step 1 to enable user-installed apps in Jira Administration - Updated step numbering (1-4 becomes 2-5) - Added note for users without admin access 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude --- docs/integrations/jira.mdx | 17 +++++++++++++---- 1 file changed, 13 insertions(+), 4 deletions(-) diff --git a/docs/integrations/jira.mdx b/docs/integrations/jira.mdx index e50e78385..ea119cc5d 100644 --- a/docs/integrations/jira.mdx +++ b/docs/integrations/jira.mdx @@ -18,12 +18,21 @@ Integrate Codegen with your Jira workspace to allow agents to interact with issu Follow these steps to successfully connect Codegen to your Jira workspace: -### 1. Create a Dedicated Jira User for Codegen +### 1. Enable User-Installed Apps in Jira +- In your Jira workspace, ensure that **user-installed apps** are enabled. +- Go to **Jira Administration** → **Applications** → **Application links** or **User-installed apps**. +- Make sure the setting to allow user-installed apps is enabled. This is required for the Codegen integration to work properly. + + + If you don't have admin access to enable user-installed apps, contact your Jira administrator to enable this setting before proceeding. + + +### 2. Create a Dedicated Jira User for Codegen - In your Jira workspace, create a new user account specifically for Codegen. - **Email:** Use an address with `codegen` in it, like `yourname+codegen@company_domain.com` or `codegen@company_domain.com`. - **Name:** Set the user's name to **Codegen**. This makes it easy to identify actions performed by Codegen in Jira. -### 2. Authorize Codegen with the New Jira User +### 3. Authorize Codegen with the New Jira User - Log in to Jira as the new Codegen user. - Go to [Codegen's Jira Integration page](https://codegen.com/integrations/jira). - Click **Connect Jira Workspace** and complete the OAuth flow **using the Codegen Jira user** you just created. @@ -32,11 +41,11 @@ Follow these steps to successfully connect Codegen to your Jira workspace: Make sure you are logged in as the Codegen Jira user when authorizing access. This is to ensure Codegen acts on behalf of the new user and not your personal account. -### 3. Switch Back to Your Own Jira Account +### 4. Switch Back to Your Own Jira Account - After connecting, log out of the Codegen Jira user in Jira. - Log back in with your personal Jira account. -### 4. Use Codegen in Your Workflow +### 5. Use Codegen in Your Workflow - On any Jira ticket, `@mention` the Codegen user (e.g., `@Codegen`) to assign or notify Codegen about the issue. - Codegen will interact with the ticket, update statuses, add comments, and link PRs as needed. From 9bfd2e4a857a9ac16abda596b6b77337deabff3b Mon Sep 17 00:00:00 2001 From: Edo Pujol Date: Fri, 12 Sep 2025 22:26:21 +0200 Subject: [PATCH 2/2] Update instructions for Jira integration setup Clarified steps for enabling user-installed apps in Jira. --- docs/integrations/jira.mdx | 1 - 1 file changed, 1 deletion(-) diff --git a/docs/integrations/jira.mdx b/docs/integrations/jira.mdx index ea119cc5d..83ed24f7c 100644 --- a/docs/integrations/jira.mdx +++ b/docs/integrations/jira.mdx @@ -20,7 +20,6 @@ Follow these steps to successfully connect Codegen to your Jira workspace: ### 1. Enable User-Installed Apps in Jira - In your Jira workspace, ensure that **user-installed apps** are enabled. -- Go to **Jira Administration** → **Applications** → **Application links** or **User-installed apps**. - Make sure the setting to allow user-installed apps is enabled. This is required for the Codegen integration to work properly.