Jira
Connect one Jira Cloud site so Ask can search and cite issues, and create, update, comment on or move issues only after you approve each change.
On this page
The Jira integration gives Ysra the issues on one Jira Cloud site as context, and lets it propose issue changes that happen only after you approve the exact action. Use it when answers in Ask should draw on issue status and comments, or when you want Ysra to file or move issues for you. This page covers both Jira connections (company search and Live actions), what each may do, and what to do when it doesn't work.
Why connect Jira#
| Connection | What it gives Ysra | Where you use it |
|---|---|---|
| Company search | Issues, statuses and comments on one site, synced so Ask can search and cite them; four kinds of proposed change. | Ask, the Integrations search box |
| Live actions (since Ysra 3.5) | Searching, reading, creating and updating in Jira and Confluence as you, live. | Ask, as @jira |
The two are connected separately; one doesn't set up the other.
Connect company search#
Start the connection#
In the web app, open Settings → Connectors. On the Jira card, select Connect. The button shows "Opening Jira…" while Atlassian loads.
Sign in to Atlassian#
Sign in with your Atlassian account and allow access.
Choose the site#
One connection covers one Jira Cloud site. If the account can see several, Ysra asks you to pick one ("Choose the company site").
Check the card#
The card shows the site, its status and three flags:
| Flag | What it means |
|---|---|
| read context | Issues, statuses and comments are synced for search in Ask. |
| scheduled sync | Ysra syncs the site automatically. |
| bounded authority | Ysra can only propose the issue actions listed below. |
Sync#
| Rule | Value |
|---|---|
| Automatic sync | About every 15 minutes; the interval can't be changed |
| Sync at once | Sync now (Retry sync after a failure) |
| What the card shows | "Last synchronized …" and "N updated · N removed" |
See How syncing works.
Connect Live actions#
Open the Jira page in Plugins#
In Settings → Connectors, open Jira. Under Live actions (“Search, read and post as you, live. Posting and changes are approved on a card first.”), choose Connect.
Sign in on Jira#
Jira's page opens: sign in and allow Ysra.
Mention it in Ask#
@jira Summarise the Confluence page on our release process
If the page says Live actions coming soon, it isn't available on the account yet.
What Ysra may do with it#
| Action | Needs your approval? |
|---|---|
Search and cite issues, statuses and comments in Ask (/jira status) |
No: read-only |
Create an issue (/jira create): card Create Jira issue |
Yes |
| Update an issue: card Update Jira issue | Yes |
Add a comment (/jira comment): card Add Jira comment |
Yes |
Move an issue to a new status (/jira move): card Move Jira issue |
Yes |
| Create or update in Jira or Confluence through @jira | Yes: a card under the answer; it runs only after Approve |
| Change projects, boards, workflows or permission schemes | Never |
| Change Jira from a routine | Not possible today: Routines can read Jira as a company source, but have no Jira grant |
The approval card in Ask#
| Button (phone) | What happens |
|---|---|
| Approve exact action (Approve) | The change is made exactly as shown, once. The card then shows Open in Jira. |
| Edit (Edit) | You change the proposal, then approve the new version. |
| Reject (No) | Nothing changes in Jira. |
See Actions and approvals and Changes in a connected service.
Disconnect#
| Connection | How |
|---|---|
| Company search | Disconnect on the Jira card. Ysra confirms "Jira disconnected and its context revoked": Jira content is no longer searchable in Ask. |
| Live actions | On the Jira page in Settings → Connectors, the ⋯ menu: Sign out or Remove. |
If it doesn't work#
Ask doesn't find an issue#
Why: the issue is on another site, or it is newer than the last sync. What to do:
- Check the issue is on the connected site (one site per connection).
- Check the card is Ready and shows "Last synchronized …".
- Select Sync now, then ask again.
The card shows Attention#
Why: a sync failed and needs you. What to do:
- Select Retry sync.
- If it fails again, Disconnect and Connect again.
A routine can't update Jira#
Why: Routines have no Jira grant today. What to do: ask for the change in Ask and approve its card, or have the routine post a summary somewhere it is allowed to.
For other symptoms, see Troubleshooting.
Related#
- Integrations — every integration, syncing, and content as data.
- Actions and approvals — how approval cards work in Ask.
- Plugins, connectors and skills — Live actions and other services.