# Jira AI integration on Definable

> A tool for bug tracking, issue tracking, and agile project management.

## What this connects

A tool for bug tracking, issue tracking, and agile project management.

Vendor: https://www.atlassian.com/software/jira

## Tools available

**94** tools available. First 12:

- `JIRA_ADD_ATTACHMENT` — Add Attachment — Uploads and attaches a file to a Jira issue.
- `JIRA_ADD_COMMENT` — Add Comment — Adds a comment using Atlassian Document Format (ADF) for rich text to an existing Jira issue.
- `JIRA_ADD_USERS_TO_PROJECT_ROLE` — Add Users to Project Role — Adds users and optionally groups to a project role.
- `JIRA_ADD_USER_TO_GROUP` — Add User to Group — Adds a user to a Jira group.
- `JIRA_ADD_WATCHER_TO_ISSUE` — Add Watcher to Issue — Adds a user to an issue's watcher list by account ID. Requires the authenticated user to have permission to view the issue and manage watchers; insufficient permissions may result in silent failure or an error response.
- `JIRA_ADD_WORKLOG` — Add Worklog — Tool to add a worklog entry to a Jira issue. Use when logging time spent on an issue.
- `JIRA_ANALYSE_EXPRESSION` — Analyse Jira Expression — Analyses Jira expressions for syntax validation, type checking, and complexity analysis. Use when you need to validate Jira expression syntax before using it in automation rules, custom fields, or workflows.
- `JIRA_ASSIGN_ISSUE` — Assign Issue — Assigns a Jira issue to a user, default assignee, or unassigns; supports email/name lookup.
- `JIRA_BULK_CREATE_ISSUE` — Bulk Create Issues — Creates multiple Jira issues (up to 50 per call) with full feature support including markdown, assignee resolution, and priority handling.
- `JIRA_CHECK_PERMISSIONS` — Check User Permissions — Check user permissions for global and project-level operations in Jira. Use this action to verify whether a user has specific permissions at the system level or within projects. Useful for authorization checks before performing operations, or for auditing user access rights.
- `JIRA_CREATE_GROUP` — Create Group — Creates a new group in Jira with the specified name.
- `JIRA_CREATE_ISSUE` — Create Issue — Creates a new Jira issue (e.g., bug, task, story) in a specified project. IMPORTANT: Different Jira projects may have custom required fields beyond the standard ones (summary, project_key, issue_type). If issue creation fails with 'field X is required', use JIRA_GET_CREATE_METADATA_ISSUE_TYPE_FIELDS (requires projectIdOrKey and issueTypeId parameters) to discover available fields for your project, or check your Jira project's configuration. Custom fields can be provided via the 'additional_properties' parameter as a JSON string (e.g., '{"customfield_12345": "value"}'). Rapid bulk creation may trigger HTTP 429 rate limiting; throttle calls and use exponential backoff on 429 responses.

## Auth

Auth schemes: `OAUTH2`, `S2S_OAUTH2`, `API_KEY`. Managed by Definable: `OAUTH2` — no client credentials required from the user.

## How agents use Jira

Inside a Definable workflow, Jira is one of the tools the **Distributor specialist** can call. Example coordination patterns:

- **Researcher → Jira** — the Researcher (GPT-5.5) pulls context from Jira (records, threads, documents), synthesises findings, and briefs the rest of the team.
- **Writer → Distributor → Jira** — the Writer (Claude Opus 4.7) drafts copy in brand voice, the Verifier passes it, then the Distributor writes the result into Jira (create record, post message, draft email).
- **Designer / Engineer → Distributor → Jira** — the Designer ships an asset or the Engineer ships a code change, the Distributor delivers it via Jira (attach file, open PR comment, post status).

The Verifier checks every Jira call. On rate limit, schema drift, or auth refresh it self-heals and retries — the workflow completes without manual intervention.

## Categories

- project management — https://definable.ai/apps/category/project-management/
- task management — https://definable.ai/apps/category/task-management/

## Related

- HTML page: https://definable.ai/apps/jira/
- Same category (project management): https://definable.ai/apps/category/project-management/
- All integrations: https://definable.ai/apps/
- Workflow (multi-agent loop): https://definable.ai/workflow/
- Apps llms.txt index: https://definable.ai/llms-apps.txt
