/rest/api/3/filter/search unofficial query params

Forge
1

Hi,

I’m using the Jira Cloud REST API endpoint:

GET /rest/api/3/filter/search?query=myQuery

and I’m seeing a different result set when I include the query parameter compared to when I call the same endpoint without it, e.g.:

GET /rest/api/3/filter/search
GET /rest/api/3/filter/search?query=myQuery

However, in the official Jira Cloud REST API documentation for GET /rest/api/3/filter/search there is no query parameter listed – only parameters like filterName, accountId, owner, groupname, groupId, projectId, id, expand, overrideSharePermissions, startAt, and maxResults.developer.atlassian

My questions are:

  1. Is the query parameter officially supported on /rest/api/3/filter/search?

  2. If yes, what exactly does it filter on (name, description, owner, JQL, etc.)?

  3. If it is an experimental or internal parameter, is it safe to rely on it in production code, or should we only use the documented parameters like filterName?

  4. Are there any plans to document this behavior (similar to how overrideSharePermissions was documented as an experimental parameter for this endpoint)?

Right now I’m hesitant to depend on query in production, because it’s not mentioned in the public docs, but it clearly affects the results in my environment.

Thanks in advance for any clarification from the Jira Cloud REST API team.