> ## Documentation Index
> Fetch the complete documentation index at: https://docs.paradime.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Jira Cloud

> Connect Jira Cloud to Paradime using an Atlassian API token so DinoAI can search, create, update, and comment on your Jira issues and tickets on your behalf.

Connect Jira Cloud to Paradime so DinoAI can access Jira on your behalf using the [Jira Tool](/products/dino-ai/tools-and-features/jira-tool).

Using **Jira Data Center** instead? See [Jira Data Center](/integrations/jira/jira-data-center) for setup instructions specific to your environment.

## Required Jira permissions

Paradime authenticates to Jira with an **Atlassian API token** (Jira Cloud) or a **Personal Access Token** (Jira Data Center). These tokens carry no scopes of their own. They act as the user who created them, so the token owner's Jira account needs the project permissions for the actions you want DinoAI to perform:

| DinoAI action                                 | Jira project permission |
| --------------------------------------------- | ----------------------- |
| Fetch, list, and search issues                | Browse Projects         |
| Create issues                                 | Create Issues           |
| Update summary, description, labels, priority | Edit Issues             |
| Change issue status                           | Transition Issues       |
| Change assignee                               | Assign Issues           |
| Add comments                                  | Add Comments            |

<Check>
  **Tip:** Connect Jira with a dedicated service account whose project permissions cover exactly the actions above. Since API tokens are unscoped, the account's permissions are the real boundary of what DinoAI can do in Jira.
</Check>

<Info>
  Read-only usage (fetching and searching issues) only requires **Browse Projects**. If your organization uses Atlassian's newer scoped API tokens, the equivalent scopes are `read:jira-work` for reading and `write:jira-work` for creating, updating, and commenting.
</Info>

See [Required Jira Permissions](/integrations/jira/required-jira-permissions) for the full permissions reference.

## Step 1: Connect Jira Cloud in Paradime

To authorize Jira, go to **Settings → Integrations** (see [connecting integrations](/integrations/connecting-integrations)), find the **Jira** integration, and click **Connect**. You'll then be prompted to enter your credentials.

<Info>
  You will need an Atlassian API key to connect Jira Cloud. See the connection parameters below for where to find each required field.
</Info>

### Connection parameters

| Field             | Description                                              | Where to find it                                                                                     |
| ----------------- | -------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- |
| **Jira Domain**   | The subdomain of your Jira Cloud account                 | Your Jira URL, e.g. `https://your-org.atlassian.net`                                                 |
| **Email Address** | The email address associated with your Atlassian account | Your Atlassian account profile                                                                       |
| **API Key**       | A personal API key to authenticate requests              | Go to [id.atlassian.com](https://id.atlassian.com) → **Security** → **Create and manage API tokens** |

Once all fields are filled in, click **Connect** to complete the connection.


## Related topics

- [Jira](/integrations/jira/index.md)
- [Jira Data Center](/integrations/jira/jira-data-center.md)
- [jira-backlog-agent](/guides/programmable-agents/jira-backlog-agent.md)
- [Integrations](/integrations/index.md)
- [Jira Tool](/products/dino-ai/tools-and-features/jira-tool.md)