> Markdown versions of all pages of this connector library are available by appending `.md` to the page URL. For the full index of connectors, see [llms.txt](https://connectors.appmixer.com/llms.txt).

# appmixer.jira.issues.FindIssues

- Component: `appmixer.jira.issues.FindIssues`
- Kind: Action
- Version: 1.0.0
- Visibility: Public
- Connector: [appmixer.jira 4.0.5](https://connectors.appmixer.com/connector/appmixer.jira/4.0.5.md)
- Component page: <https://connectors.appmixer.com/connector/appmixer.jira/4.0.5/component/appmixer.jira.issues.FindIssues>

Find issues by JQL query.

## Input ports

### Port `in`

| Field | Type | Description |
| --- | --- | --- |
| JQL Query (`query`) | textarea | JQL query string. [More about JQL](https://confluence.atlassian.com/jirasoftwarecloud/advanced-searching-764478330.html) |
| Max Results (`maxResults`) | number | Maximum number of issues to return per query. Can be up to 5000 for optimal performance with ID/key only queries. |
| Fields to Return (`fields`) | text | A list of fields to return for each issue, use it to retrieve a subset of fields. This parameter accepts a comma-separated list. **Options:** • `*all` — Returns all fields • `*navigable` — Returns navigable fields (default) • `id` — Returns only issue IDs • Any issue field, prefixed with a minus to exclude **Examples:** • `summary,comment` — Returns only summary and comments fields • `-description` — Returns all navigable fields except description • `*all,-comment` — Returns all fields except comments • `id,key,summary,status` — Returns specific fields only |
| Issue Properties (`properties`) | text | Comma-separated list of up to 5 issue properties to include in results. Example: 'property1,property2' |
| Reference Fields by Keys (`fieldsByKeys`) | toggle | When enabled, fields are referenced by their keys rather than IDs in the response |
| Fail Fast (`failFast`) | toggle | When enabled, the request fails early if all field data cannot be retrieved |
| Output Type (`outputType`) | select | Choose whether you want to receive the result set as one complete list, or first item only or one item at a time or stream the items to a file. |

## Output ports

### Port `issue`

Variables are loaded dynamically from `/component/appmixer/jira/issues/GenerateIssuesOutput?outPort=out&ignoreAuth=true`.

### Port `notFound`

_No fields defined for this port._

## Full metadata (component.json)

```json
{
  "name": "appmixer.jira.issues.FindIssues",
  "description": "Find issues by JQL query.",
  "author": "Jimoh Damilola <jimoh@client.io>",
  "auth": {
    "service": "appmixer:jira",
    "scope": [
      "read:jira-work"
    ]
  },
  "inPorts": [
    {
      "name": "in",
      "schema": {
        "type": "object",
        "properties": {
          "query": {
            "type": "string"
          },
          "maxResults": {
            "type": "number"
          },
          "fields": {
            "type": "string"
          },
          "properties": {
            "type": "string"
          },
          "fieldsByKeys": {
            "type": "boolean"
          },
          "failFast": {
            "type": "boolean"
          },
          "outputType": {
            "type": "string"
          }
        },
        "required": [
          "query"
        ]
      },
      "inspector": {
        "inputs": {
          "query": {
            "type": "textarea",
            "label": "JQL Query",
            "tooltip": "JQL query string. <a href=\"https://confluence.atlassian.com/jirasoftwarecloud/advanced-searching-764478330.html\" target=\"_blank\">More about JQL</a>",
            "index": 1
          },
          "maxResults": {
            "type": "number",
            "label": "Max Results",
            "tooltip": "Maximum number of issues to return per query. Can be up to 5000 for optimal performance with ID/key only queries.",
            "index": 2,
            "min": 1,
            "max": 5000,
            "step": 1,
            "defaultValue": 50
          },
          "fields": {
            "type": "text",
            "label": "Fields to Return",
            "tooltip": "A list of fields to return for each issue, use it to retrieve a subset of fields. This parameter accepts a comma-separated list.<br><br><strong>Options:</strong><br>• <code>*all</code> — Returns all fields<br>• <code>*navigable</code> — Returns navigable fields (default)<br>• <code>id</code> — Returns only issue IDs<br>• Any issue field, prefixed with a minus to exclude<br><br><strong>Examples:</strong><br>• <code>summary,comment</code> — Returns only summary and comments fields<br>• <code>-description</code> — Returns all navigable fields except description<br>• <code>*all,-comment</code> — Returns all fields except comments<br>• <code>id,key,summary,status</code> — Returns specific fields only",
            "index": 3,
            "defaultValue": "*navigable"
          },
          "properties": {
            "type": "text",
            "label": "Issue Properties",
            "tooltip": "Comma-separated list of up to 5 issue properties to include in results. Example: 'property1,property2'",
            "index": 4
          },
          "fieldsByKeys": {
            "type": "toggle",
            "label": "Reference Fields by Keys",
            "tooltip": "When enabled, fields are referenced by their keys rather than IDs in the response",
            "index": 5,
            "defaultValue": false
          },
          "failFast": {
            "type": "toggle",
            "label": "Fail Fast",
            "tooltip": "When enabled, the request fails early if all field data cannot be retrieved",
            "index": 6,
            "defaultValue": false
          },
          "outputType": {
            "type": "select",
            "label": "Output Type",
            "index": 7,
            "defaultValue": "array",
            "tooltip": "Choose whether you want to receive the result set as one complete list, or first item only or one item at a time or stream the items to a file.",
            "options": [
              {
                "label": "First Item Only",
                "value": "first"
              },
              {
                "label": "All items at once",
                "value": "array"
              },
              {
                "label": "One item at a time",
                "value": "object"
              },
              {
                "label": "Store to CSV file",
                "value": "file"
              }
            ]
          }
        }
      }
    }
  ],
  "outPorts": [
    {
      "name": "issue",
      "source": {
        "url": "/component/appmixer/jira/issues/GenerateIssuesOutput?outPort=out&ignoreAuth=true",
        "data": {
          "properties": {
            "outputType": "inputs/in/outputType"
          },
          "messages": {
            "in/query": "any"
          },
          "transform": "./GenerateIssuesOutput#getOutputOptions"
        }
      }
    },
    {
      "name": "notFound"
    }
  ],
  "icon": "(data URI omitted)"
}
```
