# Jira

> Connect your Jira account to browse projects and create, update, and search issues.

App · Project Management · 7 actions. Web page: https://docs.lodol.com/docs/integrations/jira

## Actions

### Add a comment to a Jira issue

Post a comment on a Jira issue.

**Inputs**

- Issue key (`issue_key`, text, required): Key of the Jira issue to comment on, for example PROJ-123.
- Comment text (`body`, text, required): Text of the comment to post.

**Outputs**

- `comment` (object): Comment details

**Example output**

```json
{
  "comment": {
    "body": "Sample text content",
    "id": "abc123xyz789",
    "issue_key": {
      "id": "abc123",
      "name": "Sample"
    }
  }
}
```

### Create a Jira issue

Create a new Jira issue with a title and an optional description, priority, and assignee.

**Inputs**

- Project key (`project_key`, text, required): Key of the Jira project to create the issue in, for example PROJ.
- Summary (`summary`, text, required): Title of the issue.
- Description (`description`, text): Longer description of the issue. Supports Jira's text formatting.
- Issue type (`issue_type`, text): Type of issue to create, for example Task, Bug, or Story.
- Priority (`priority`, text): Name of the priority to set, for example High or Low.
- Assignee account ID (`assignee_account_id`, text): Account ID of the person to assign the issue to.

**Outputs**

- `issue` (object): Issue details

**Example output**

```json
{
  "issue": {
    "id": "abc123xyz789",
    "key": "example_value",
    "self": "example_value"
  }
}
```

### Get a Jira issue

Look up a Jira issue's details, including its title and status.

**Inputs**

- Issue key (`issue_key`, text, required): Key of the Jira issue to look up, for example PROJ-123.

**Outputs**

- `issue` (object): Issue details

**Example output**

```json
{
  "issue": {
    "id": "abc123xyz789",
    "key": "example_value",
    "status": {
      "id": "1",
      "name": "In Progress"
    },
    "summary": "example_value"
  }
}
```

### List Jira projects

List the Jira projects your connected account can access.

**Inputs**: None.

**Outputs**

- `projects` (list): Array of Jira projects accessible to the authenticated user. Each project contains id, key, and name. Use the key field when creating issues

**Example output**

```json
{
  "projects": [
    {
      "id": "proj123",
      "key": "PROJ",
      "name": "Development"
    }
  ]
}
```

### List transitions for a Jira issue

List the status changes (transitions) available for a Jira issue based on its current status.

**Inputs**

- Issue key (`issue_key`, text, required): Key of the Jira issue to get transitions for, for example PROJ-123.

**Outputs**

- `transitions` (list): Array of available transitions for the issue. Use the id field with transition_issue to move the issue

**Example output**

```json
{
  "transitions": [
    {
      "id": "21",
      "name": "In Progress",
      "to": {
        "id": "3",
        "name": "In Progress"
      }
    }
  ]
}
```

### Move a Jira issue to a new status

Move a Jira issue to a new status by applying a transition ID.

**Inputs**

- Issue key (`issue_key`, text, required): Key of the Jira issue to move, for example PROJ-123.
- Transition ID (`transition_id`, text, required): ID of the transition to apply. Use the list transitions action to find the available IDs.

**Outputs**

- `issue_key` (text): Jira issue key (format: PROJ-123)
- `transition_id` (text): Transition ID that was applied. Available from Jira's workflow configuration for the project

**Example output**

```json
{
  "issue_key": {
    "id": "abc123",
    "name": "Sample"
  },
  "transition_id": {
    "id": "abc123",
    "name": "Sample"
  }
}
```

### Search Jira issues

Find Jira issues using a Jira search query (JQL).

**Inputs**

- Search query (JQL) (`jql`, text, required): What to search for, written as a Jira search query (JQL). For example: project = PROJ AND status = 'In Progress'.
- Max results (`max_results`, number): Maximum number of results to return, from 1 to 100.
- Next page token (`next_page_token`, text): To get more results, enter the next page token returned by the previous search.

**Outputs**

- `issues` (list): Array of Jira issues matching the search query. Each issue contains id, key, summary, status, assignee, created, updated, priority and issue_type. Use the key to perform actions on specific issues
- `next_page_token` (text): Cursor token for fetching the next page. Absent when there are no more results

**Example output**

```json
{
  "issues": [
    {
      "assignee": {
        "accountId": "5b10a2844c20165700ede21g",
        "displayName": "Alex Kim",
        "emailAddress": "alex.kim@example.com"
      },
      "created": "2026-10-01T09:30:00.000+0000",
      "id": "item123",
      "issue_type": "Bug",
      "key": "PROJ-1",
      "priority": "High",
      "status": {
        "id": "1",
        "name": "To Do",
        "statusCategory": {
          "key": "new",
          "name": "To Do"
        }
      },
      "summary": "Sample Task",
      "updated": "2026-10-05T14:10:00.000+0000"
    }
  ]
}
```