You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
docs: add requirement for user-installed apps in Jira integration (#1242)
## Summary - Added 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: "Enable User-Installed Apps in Jira" with navigation instructions - Updated step numbering from 1-4 to 2-5 to accommodate the new step - Added a helpful note for users who don't have admin access ## Test plan - [x] Review the updated documentation for clarity and completeness - [x] Verify that the step-by-step instructions are accurate - [x] Ensure the formatting and markdown syntax are correct 🤖 Generated with [Claude Code](https://claude.ai/code) --- [💻 View my work](https://codegen.com/agent/trace/92036) • 👤 Initiated by @kopekC • [About Codegen](https://codegen.com) [⛔ Remove Codegen from PR](https://codegen.com/agent/trace/92036/remove-from-pr) • [🚫 Ban action checks](https://codegen.com/agent/trace/92036/ban) --------- Co-authored-by: codegen-sh[bot] <131295404+codegen-sh[bot]@users.noreply.github.com> Co-authored-by: Claude <noreply@anthropic.com> Co-authored-by: Edo Pujol <ed@codegen.com>
Copy file name to clipboardExpand all lines: docs/integrations/jira.mdx
+12-4Lines changed: 12 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -18,12 +18,20 @@ Integrate Codegen with your Jira workspace to allow agents to interact with issu
18
18
19
19
Follow these steps to successfully connect Codegen to your Jira workspace:
20
20
21
-
### 1. Create a Dedicated Jira User for Codegen
21
+
### 1. Enable User-Installed Apps in Jira
22
+
- In your Jira workspace, ensure that **user-installed apps** are enabled.
23
+
- Make sure the setting to allow user-installed apps is enabled. This is required for the Codegen integration to work properly.
24
+
25
+
<Note>
26
+
If you don't have admin access to enable user-installed apps, contact your Jira administrator to enable this setting before proceeding.
27
+
</Note>
28
+
29
+
### 2. Create a Dedicated Jira User for Codegen
22
30
- In your Jira workspace, create a new user account specifically for Codegen.
23
31
-**Email:** Use an address with `codegen` in it, like `yourname+codegen@company_domain.com` or `codegen@company_domain.com`.
24
32
-**Name:** Set the user's name to **Codegen**. This makes it easy to identify actions performed by Codegen in Jira.
25
33
26
-
### 2. Authorize Codegen with the New Jira User
34
+
### 3. Authorize Codegen with the New Jira User
27
35
- Log in to Jira as the new Codegen user.
28
36
- Go to [Codegen's Jira Integration page](https://codegen.com/integrations/jira).
29
37
- Click **Connect Jira Workspace** and complete the OAuth flow **using the Codegen Jira user** you just created.
@@ -32,11 +40,11 @@ Follow these steps to successfully connect Codegen to your Jira workspace:
32
40
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.
33
41
</Warning>
34
42
35
-
### 3. Switch Back to Your Own Jira Account
43
+
### 4. Switch Back to Your Own Jira Account
36
44
- After connecting, log out of the Codegen Jira user in Jira.
37
45
- Log back in with your personal Jira account.
38
46
39
-
### 4. Use Codegen in Your Workflow
47
+
### 5. Use Codegen in Your Workflow
40
48
- On any Jira ticket, `@mention` the Codegen user (e.g., `@Codegen`) to assign or notify Codegen about the issue.
41
49
- Codegen will interact with the ticket, update statuses, add comments, and link PRs as needed.
0 commit comments