Jira

What it can do

• Read: List Jira sites this sign-in can use, Get the signed-in Jira user, Get Jira site address, Search projects, Get a project, List statuses for a project, List issue types you can create, Get fields for a new issue, Search issues with JQL, Get an issue, List comments on an issue, Get a comment, List transitions for an issue and Find people who can be assigned.
• Change: Create an issue, Update an issue, Move an issue through a transition, Add a comment and Update a comment.
• Watches: Register issue webhooks, List registered webhooks, Extend webhook life and Delete webhooks.

Calls go to the Jira site id from List Jira sites this sign-in can use, not to the site's own web address. Description and comment text use Atlassian's document format, not a plain sentence. Read Get fields for a new issue before creating one. A search page is at most 100 issues. This app does not include attachments, deleting an issue, worklogs, issue links, or boards and sprints.

What can start a workflow

• Issue created and Issue updated.
• These last 30 days. Extend webhook life renews them. The notice is signed. A secret in the address is not accepted.

How to connect

Open Connections, then Apps. In the Apps heading, search with Search apps to add and choose Add on Jira.

When the panel offers Who signs in, pick Sign in as the company (one account for every agent) or Each person signs in to their own account when first needed.

Read what it asks for. If it has not said, the panel says You'll see what Jira asks for on its own sign-in page. Choose Continue to Jira and finish there. Do not paste a password into Studio. When it works, the row says Connected.

If it says This app can't be connected here yet: it needs a sign-in setup this server doesn't have. or Connecting Jira opens soon on this server., this server cannot sign Jira in yet. If you do not see Add, ask an admin to add Jira.

What it asks for

• Read Jira work (read:jira-work) and read users (read:jira-user).
• Create and change issues, move them, and comment (write:jira-work).
• Register watches (manage:jira-webhook).
• Stay signed in (offline_access). Refresh replaces the previous refresh.