# Search Jira issues

Canonical URL: https://docs.fuse.init.inc/integrations/jira/actions/issues.search

Search Jira issues with enhanced JQL, explicit fields, and token pagination.

Action ID: `issues.search`
Provider: Jira (`jira`)
Contract version: 1

## Risk and exposure

- Risk: Read
- Idempotency: Safe — Safe to retry without coordination; repeats do not create additional side effects.
- Availability: Default
- Exposure: REST, SDK, MCP
- MCP hints: readOnly=true, destructive=false, idempotent=true, openWorld=true

## Required scopes

- `read:jira-work`
- `offline_access`

## Input schema fields

- `jql`
- `fields`
- `fields[]`
- `max_results`
- `next_page_token`

## Output schema fields

- `issues`
- `issues[]`
- `issues[].id`
- `issues[].key`
- `issues[].self`
- `issues[].summary`
- `issues[].status`
- `issues[].status.id`
- `issues[].status.name`
- `issues[].status.category_key`
- `issues[].assignee`
- `issues[].assignee.account_id`
- `issues[].assignee.display_name`
- `issues[].assignee.active`
- `issues[].reporter`
- `issues[].reporter.account_id`
- `issues[].reporter.display_name`
- `issues[].reporter.active`
- `issues[].issuetype`
- `issues[].issuetype.id`
- `issues[].issuetype.key`
- `issues[].issuetype.name`
- `issues[].project`
- `issues[].project.id`
- `issues[].project.key`
- `issues[].project.name`
- `issues[].priority`
- `issues[].priority.id`
- `issues[].priority.key`
- `issues[].priority.name`
- `issues[].labels`
- `issues[].labels[]`
- `issues[].description`
- `issues[].description.type`
- `issues[].description.version`
- `issues[].description.content`
- `issues[].description.content[]`
- `issues[].description.content[].type`
- `issues[].description.content[].attrs`
- `issues[].description.content[].attrs.level`
- `issues[].description.content[].content`
- `issues[].description.content[].content[]`
- `issues[].description.content[].content[].type`
- `issues[].description.content[].content[].text`
- `issues[].description.content[].content[].marks`
- `issues[].description.content[].content[].marks[]`
- `issues[].description.content[].content[].marks[].type`
- `issues[].description.content[].content[].marks[].attrs`
- `issues[].description.content[].content[].marks[].attrs.href`
- `issues[].description.content[].content[].attrs`
- `issues[].description.content[].content[].attrs.level`
- `issues[].description.content[].content[].content`
- `issues[].description.content[].content[].content[]`
- `issues[].description.content[].content[].content[].type`
- `issues[].description.content[].content[].content[].text`
- `issues[].description.content[].content[].content[].marks`
- `issues[].description.content[].content[].content[].marks[]`
- `issues[].description.content[].content[].content[].marks[].type`
- `issues[].description.content[].content[].content[].marks[].attrs`
- `issues[].description.content[].content[].content[].marks[].attrs.href`
- `issues[].description.content[].content[].content[].attrs`
- `issues[].description.content[].content[].content[].attrs.level`
- `issues[].description.content[].content[].content[].content`
- `issues[].description.content[].content[].content[].content[]`
- `issues[].description.content[].content[].content[].content[].type`
- `issues[].description.content[].content[].content[].content[].text`
- `issues[].description.content[].content[].content[].content[].marks`
- `issues[].description.content[].content[].content[].content[].marks[]`
- `issues[].description.content[].content[].content[].content[].marks[].type`
- `issues[].description.content[].content[].content[].content[].marks[].attrs`
- `issues[].description.content[].content[].content[].content[].marks[].attrs.href`
- `issues[].created`
- `issues[].updated`
- `issues[].parent`
- `issues[].parent.id`
- `issues[].parent.key`
- `issues[].parent.name`
- `next_page_token`

Provider overview: https://docs.fuse.init.inc/integrations/jira
Actions index: https://docs.fuse.init.inc/integrations/jira/actions
Exact canonical JSON contract: https://docs.fuse.init.inc/api/catalog/v1/providers/jira/actions/issues.search
Deployment-effective discovery: https://api.fuse.init.inc/v1/tenants/%7Btenant_id%7D/providers/jira/actions