> Index of every Falcon docs page, for assistants: https://falcon.com/docs/llms.txt

# Jira

Search and update Jira Cloud issues, add comments, and start a workflow when an issue is created or updated.

## 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.

## Related

- [Asana](https://falcon.com/docs/app-asana)
- [Linear](https://falcon.com/docs/app-linear)
- [Connections](https://falcon.com/docs/connections)