From 568f22701e42072c93c12dc3629160ab8a475b87 Mon Sep 17 00:00:00 2001 From: jasonkeung Date: Fri, 17 Jul 2026 13:06:43 -0400 Subject: [PATCH 1/2] docs: publish Jira integration page with self-serve setup flow - Remove draft flag from the Jira integration page - Rewrite setup for the self-serve flow: install from the Oz web app, configure via Manage apps in Jira, and connect to a Warp workspace - Document the account-binding flow for run attribution - Replace the inaccurate error-code tip with actual failed-to-start behavior - Add Jira to the Integrations sidebar and overview page Co-Authored-By: Oz --- .../docs/platform/integrations/index.mdx | 4 +- .../docs/platform/integrations/jira.mdx | 52 ++++++++++++++----- src/sidebar.ts | 1 + 3 files changed, 42 insertions(+), 15 deletions(-) diff --git a/src/content/docs/platform/integrations/index.mdx b/src/content/docs/platform/integrations/index.mdx index 2be2245d8..3f1f45ad4 100644 --- a/src/content/docs/platform/integrations/index.mdx +++ b/src/content/docs/platform/integrations/index.mdx @@ -7,7 +7,7 @@ description: >- --- import VideoEmbed from '@components/VideoEmbed.astro'; -Warp integrations let your team trigger agents directly from the terminal, or from tools like [Slack](/platform/integrations/slack/) and [Linear](/platform/integrations/linear/). Once set up, agents can: +Warp integrations let your team trigger agents directly from the terminal, or from tools like [Slack](/platform/integrations/slack/), [Linear](/platform/integrations/linear/), and [Jira](/platform/integrations/jira/). Once set up, agents can: * Read conversation or issue context * Run code inside your codebase in a remote environment @@ -31,7 +31,7 @@ Use the setup walkthrough below for a quick look at how environments connect to * [Integrations quickstart](/platform/integrations/quickstart/) - Trigger your first agent from Slack and watch the run from start to finish. * [Integration setup](/reference/cli/integration-setup/) - Configure environments, GitHub authorization, CLI flags, and integrations in more detail. -* [Slack](/platform/integrations/slack/) and [Linear](/platform/integrations/linear/) - Trigger agents from team conversations, issues, and comments. +* [Slack](/platform/integrations/slack/), [Linear](/platform/integrations/linear/), and [Jira](/platform/integrations/jira/) - Trigger agents from team conversations, issues, and comments. * [GitHub Actions](/platform/integrations/github-actions/) - Run agents from CI workflows and repository events. * [GitLab](/platform/integrations/gitlab/), [Bitbucket](/platform/integrations/bitbucket/), and [Azure DevOps](/platform/integrations/azure-devops/) - Connect non-GitHub repositories with tokens and Warp-managed secrets. * [AWS, GCP, and other cloud providers](/platform/integrations/cloud-providers/) - Give cloud agents short-lived access to cloud services. diff --git a/src/content/docs/platform/integrations/jira.mdx b/src/content/docs/platform/integrations/jira.mdx index 87ed7f395..68ab903b0 100644 --- a/src/content/docs/platform/integrations/jira.mdx +++ b/src/content/docs/platform/integrations/jira.mdx @@ -1,6 +1,5 @@ --- title: Jira integration -draft: true sidebar: label: "Jira" description: >- @@ -23,19 +22,35 @@ The Jira integration lets your team kick off cloud agent runs directly from Jira ### Setup -#### 1. Install the Oz app in Jira +#### 1. Open the Jira app installation page -The Oz app is not yet published to the Atlassian marketplace. Install the Oz app into your Jira Cloud site using the link provided by your Warp contact. Only Jira site admins can install apps. +In the [Oz web app](https://oz.warp.dev/integrations), find Jira and click **Set up**. On the Atlassian installation page, click **Get app**. -#### 2. Connect your Jira site to Warp +#### 2. Install Oz on your Jira site -After installing the app, open the app's **Configure** screen inside Jira. This takes you to a Warp page to connect your app installation to your Warp workspace. +Choose the Jira Cloud site you want to connect, review the requested permissions, and install Oz. Only Jira site admins can install apps. -Once connected, the integration is active for all members of your Warp team. +#### 3. Open the Oz configuration page -#### 3. (Optional) Configure the default environment, model, and harness +In your Jira site, open **Manage apps**. Find Oz, open its three-dot actions menu, then click **Configure**. -In the [Oz web app](https://oz.warp.dev/integrations), open your Jira integration to set the default [environment](/platform/environments/), model, and harness Oz uses for Jira-triggered runs. If you don't set these, Oz uses your team's default configuration. +The configuration page URL for the production app follows this pattern: + +```text +https://.atlassian.net/jira/settings/apps/configure/40dbc167-16d9-4b68-9752-277c5a52aa01/34808a52-a321-44c2-bac4-a15eb316df50/static/warp-jira-configure/34808a52-a321-44c2-bac4-a15eb316df50 +``` + +Replace `` with your Jira Cloud site ID. + +#### 4. Connect Jira to your Warp workspace + +On the Oz configuration page in Jira, click **Connect to Warp**. Sign in to Warp if prompted. Warp automatically binds the Jira installation to your Warp workspace. + +The confirmation page displays **Jira connected** when the connection succeeds. Jira-triggered runs are now available to members of the connected Warp workspace. + +#### 5. (Optional) Configure the default environment, model, and harness + +Return to the [Integrations page in the Oz web app](https://oz.warp.dev/integrations), then click **Edit Jira** to set the default [environment](/platform/environments/), model, harness, and agent for Jira-triggered runs. If you don't change these settings, Oz uses your workspace's default configuration. --- @@ -45,6 +60,20 @@ Add the label **`oz-agent`** to any Jira issue. Oz will pick it up, post a comme When the run finishes, Oz posts a summary comment to the issue with links to any pull requests or branches it created, along with a link to the full conversation in Warp. To track runs across your team, open the [Agent Management Panel](/platform/managing-cloud-agents/) in the Warp app, where Jira-triggered runs appear in the **All** tab. +#### Connecting your Jira account to Warp + +The first time you trigger a run, Oz posts a comment prompting you to connect your Jira account to Warp. Connecting attributes your Jira-triggered runs to your Warp account; the run starts either way. + +1. Follow the link in the comment to open the Warp page in your Jira personal settings. The link for the production app follows this pattern: + + ```text + https://.atlassian.net/jira/settings/personal/apps/40dbc167-16d9-4b68-9752-277c5a52aa01/34808a52-a321-44c2-bac4-a15eb316df50 + ``` + +2. Click **Connect to Warp**. A Warp page opens and links your account automatically. Sign in to Warp first if prompted. + +The page displays **Jira account connected** when the link succeeds, and the settings page shows a **Connected to Warp** badge. Runs you trigger from then on are attributed to you. + --- ### Troubleshooting @@ -54,11 +83,8 @@ If Oz doesn't respond after adding the label, check that: * The Oz app is installed and the workspace is connected (see the app's **Configure** screen in Jira). * The issue is in Jira Cloud (not Server or Data Center). -:::tip -When a Jira-triggered run can't start, Oz posts an error comment on the issue. Common codes: - -* [`feature_not_available`](/reference/api-and-sdk/troubleshooting/errors/feature-not-available/) - your plan doesn't support integrations. -* [`integration_disabled`](/reference/api-and-sdk/troubleshooting/errors/integration-disabled/) - the integration was removed or disabled. +:::note +When a Jira-triggered run fails to start, Oz updates its comment on the issue to say it could not start the task. Re-add the `oz-agent` label to try again; a new attempt starts a new comment thread. ::: For other issues, reach out to your Warp contact or join the [Warp community on Slack](https://go.warp.dev/join-preview). diff --git a/src/sidebar.ts b/src/sidebar.ts index 0baeebbe5..b770e1bb3 100644 --- a/src/sidebar.ts +++ b/src/sidebar.ts @@ -363,6 +363,7 @@ export const sidebarTopics: StarlightSidebarTopicsUserConfig = [ { slug: 'platform/integrations/quickstart', label: 'Quickstart' }, 'platform/integrations/slack', 'platform/integrations/linear', + 'platform/integrations/jira', { label: 'GitHub Actions', collapsed: true, From 764bc5d620dc52a2b69250fbf90075dc5c6e2e15 Mon Sep 17 00:00:00 2001 From: jasonkeung Date: Fri, 17 Jul 2026 14:45:15 -0400 Subject: [PATCH 2/2] docs: rename Jira URL placeholder to your-site-subdomain Co-Authored-By: Oz --- src/content/docs/platform/integrations/jira.mdx | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/src/content/docs/platform/integrations/jira.mdx b/src/content/docs/platform/integrations/jira.mdx index 68ab903b0..08a8b26dc 100644 --- a/src/content/docs/platform/integrations/jira.mdx +++ b/src/content/docs/platform/integrations/jira.mdx @@ -37,10 +37,10 @@ In your Jira site, open **Manage apps**. Find Oz, open its three-dot actions men The configuration page URL for the production app follows this pattern: ```text -https://.atlassian.net/jira/settings/apps/configure/40dbc167-16d9-4b68-9752-277c5a52aa01/34808a52-a321-44c2-bac4-a15eb316df50/static/warp-jira-configure/34808a52-a321-44c2-bac4-a15eb316df50 +https://.atlassian.net/jira/settings/apps/configure/40dbc167-16d9-4b68-9752-277c5a52aa01/34808a52-a321-44c2-bac4-a15eb316df50/static/warp-jira-configure/34808a52-a321-44c2-bac4-a15eb316df50 ``` -Replace `` with your Jira Cloud site ID. +Replace `` with your Jira Cloud site subdomain. #### 4. Connect Jira to your Warp workspace @@ -67,7 +67,7 @@ The first time you trigger a run, Oz posts a comment prompting you to connect yo 1. Follow the link in the comment to open the Warp page in your Jira personal settings. The link for the production app follows this pattern: ```text - https://.atlassian.net/jira/settings/personal/apps/40dbc167-16d9-4b68-9752-277c5a52aa01/34808a52-a321-44c2-bac4-a15eb316df50 + https://.atlassian.net/jira/settings/personal/apps/40dbc167-16d9-4b68-9752-277c5a52aa01/34808a52-a321-44c2-bac4-a15eb316df50 ``` 2. Click **Connect to Warp**. A Warp page opens and links your account automatically. Sign in to Warp first if prompted.