v4

latestOpenAPI 3.0.1Apache 2.02026-08-016079122.3 MB
Issue search

Get issue picker suggestions

Returns lists of issues matching a query string. Use this resource to provide auto-completion suggestions when the user is looking for an issue using a word or string.

This operation returns two lists:

  • History Search which includes issues from the user's history of created, edited, or viewed issues that contain the string in the query parameter.
  • Current Search which includes issues that match the JQL expression in currentJQL and contain the string in the query parameter.

This operation can be accessed anonymously.

Permissions required: None.

get/rest/api/2/issue/picker

Query parameters

querystring
Example:query

A string to match against text fields in the issue such as title, description, or comments.

currentJQLstring

A JQL query defining a list of issues to search for the query term. Note that username and userkey cannot be used as search terms for this parameter, due to privacy reasons. Use accountId instead.

currentIssueKeystring

The key of an issue to exclude from search results. For example, the issue the user is viewing when they perform this query.

currentProjectIdstring

The ID of a project that suggested issues must belong to.

showSubTasksboolean

Indicate whether to include subtasks in the suggestions list.

showSubTaskParentboolean

When currentIssueKey is a subtask, whether to include the parent issue in the suggestions if it matches the query.

Response

Returned if the request is successful.