Skip to main content

​
Overview

The Jira tools integrate with Atlassian Jira Cloud REST API v3 to help you manage project progress from your workflows. You can create, search, update, and transition issues, add comments, and discover projects.

​
Key Features

  • JIRA_CREATE_ISSUE
    • Create an issue (task, story, bug, or sub-task) in a Jira project.
  • JIRA_GET_ISSUE
    • Fetch a single issue by its key (e.g. PROJ-123) or numeric ID.
  • JIRA_SEARCH_ISSUES
    • Search issues with a JQL query using the enhanced /search/jql endpoint. Returns paginated results with a nextPageToken.
  • JIRA_UPDATE_ISSUE
    • Update fields on an existing issue: summary, description, assignee, priority, and labels.
  • JIRA_TRANSITION_ISSUE
    • Move an issue to a new status (e.g. To Do → In Progress → Done), with an optional comment.
  • JIRA_ADD_COMMENT
    • Add a comment to an issue. Accepts plain text and converts it to Atlassian Document Format (ADF) automatically.
  • JIRA_LIST_PROJECTS
    • List all accessible projects to discover project keys.

​
Authentication

For setup instructions, see the Jira credentials page. Each step requires three configuration fields:
Config fieldDescription
base_urlYour Jira site URL, e.g. https://your-domain.atlassian.net
emailYour Atlassian account email
api_tokenA Jira API token (select from workspace secrets)

​
Example: Create and Search Issues

- id: create_issue
  tool: JIRA_CREATE_ISSUE
  config:
    - name: base_url
      value: "https://your-domain.atlassian.net"
    - name: email
      value: "you@example.com"
    - name: api_token
      secret: "YOUR_JIRA_SECRET"
  input:
    - name: project_key
      value: "PROJ"
    - name: summary
      value: "Fix login bug"
    - name: issue_type
      value: "Bug"
- id: search_issues
  tool: JIRA_SEARCH_ISSUES
  config:
    - name: base_url
      value: "https://your-domain.atlassian.net"
    - name: email
      value: "you@example.com"
    - name: api_token
      secret: "YOUR_JIRA_SECRET"
  input:
    - name: jql
      value: "project = PROJ AND status = 'In Progress'"

​
Notes

  • ADF conversion: Rich-text fields (description, comment body) accept plain text. The tool automatically converts each line into an Atlassian Document Format paragraph.
  • Assignee: Jira identifies users by accountId, not name or email. Pass the accountId visible in the user’s profile URL.
  • At-least-once side effects: JIRA_CREATE_ISSUE and JIRA_ADD_COMMENT may create duplicates if a worker restarts after the call. De-duplicate downstream if exactly-once semantics matter.
  • Timeouts: Every request has a 30-second timeout via AbortSignal.timeout.