# Jira

Baton Jira Connector - Sync users, groups, and projects from Atlassian Jira

## Prerequisites

- A Mesh administrator account with permission to manage connectors.
- `jira_url` — Jira instance URL (for example https://yourcompany.atlassian.net)
- `jira_email` — Email address associated with the API token
- Credentials for authentication: jira_api_token (stored write-only).

## Authentication

**Method:** Bearer token

Mesh authenticates with a token (personal access token, API token, or bot token).

| Field | Required | Secret | Description |
| --- | --- | --- | --- |
| `jira_api_token` | Yes | Yes (write-only) | Jira API Token (stored as secret) |

## Capabilities

<CapabilityMatrix
  capabilities={[
    { name: "Identity & entitlement sync", supported: true },
    { name: "Writeback / remediation", supported: false, notes: "Read-only" },
  ]}
/>

## Data model

_This information is not yet available from the connector schema._

## Setup

1. Gather the required value: `jira_url`.
2. Gather the required value: `jira_email`.
3. Create the required credentials in the source system: jira_api_token.
4. In Admin → Connectors, add the connector and enter its configuration.
5. Save and run an initial collection.

## Troubleshooting

_This information is not yet available from the connector schema._