Jira

Jira Filters API

This resource represents [filters](https://confluence.atlassian.com/x/eQiiLQ). Use it to get, create, update, or delete filters. Also use it to configure the columns for a filter and set favorite filters.

GitHub OpenAPI

Operations 13

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /rest/api/3/filter Save a JQL search as a filter · Create filter #
Ask an LLM
“How do I save a JQL query as a reusable filter?”
“Can I share a new filter with a group when I create it?”
Tell an agent
Create a filter named {name} with JQL {jql}.
Save filter {name} for {jql} and mark it as a favorite ({favourite}).
GET /rest/api/3/filter/favourite List my favorite filters · Get favorite filters #
Ask an LLM
“Which filters have I starred as favorites?”
“Can I see my favorite filters along with their share permissions?”
Tell an agent
List my favorite filters.
Show my starred filters with {expand} expanded.
GET /rest/api/3/filter/my List filters I own · Get my filters #
Ask an LLM
“What filters have I created myself?”
“Can I list the filters I own together with my favorites?”
Tell an agent
List the filters I own.
Show my own filters and include favorites ({includeFavourites}).
GET /rest/api/3/filter/search Search filters by name, owner or project · Search for filters #
Ask an LLM
“How can I find a filter by part of its name?”
“Can I search for filters owned by a specific person or shared with a project?”
Tell an agent
Search for filters whose name contains {filterName}.
Find filters owned by account {accountId}, ordered by {orderBy}.
DELETE /rest/api/3/filter/{id} Delete a filter · Delete filter #
Ask an LLM
“Who is allowed to delete a saved filter?”
“Can I permanently remove a filter I created?”
Tell an agent destructive · confirm first
Delete filter {id}.
Remove saved filter {id} permanently.
GET /rest/api/3/filter/{id} Get a filter · Get filter #
Ask an LLM
“What JQL is behind a particular saved filter?”
“Can I look up one filter's owner and sharing by its ID?”
Tell an agent
Get filter {id}.
Show the JQL and share settings for filter {id}.
PUT /rest/api/3/filter/{id} Update a filter's name, JQL or sharing · Update filter #
Ask an LLM
“How do I change the JQL of a filter I own?”
“Can I update who a saved filter is shared with?”
Tell an agent
Change the JQL of filter {id} to {jql}, keeping the name {name}.
Rename filter {id} to {name}.
DELETE /rest/api/3/filter/{id}/columns Reset a filter's columns to default · Reset columns #
Ask an LLM
“Can I undo my custom columns on a filter and go back to the default?”
“What resets the column layout of a filter?”
Tell an agent destructive · confirm first
Reset the columns of filter {id} to the default.
Clear my column configuration for filter {id}.
GET /rest/api/3/filter/{id}/columns Get a filter's list view columns · Get columns #
Ask an LLM
“Which columns show when a filter's results are viewed in list view?”
“Can I read the column configuration of a filter?”
Tell an agent
Get the columns configured for filter {id}.
Show which fields appear as columns for filter {id}.
PUT /rest/api/3/filter/{id}/columns Set a filter's list view columns · Set columns #
Ask an LLM
“How do I choose which columns a filter displays?”
“Can any field be a filter column, or only navigable ones?”
Tell an agent
Set the columns of filter {id} to {columns}.
Configure filter {id} to show columns {columns} in list view.
DELETE /rest/api/3/filter/{id}/favourite Remove a filter from my favorites · Remove filter as favorite #
Ask an LLM
“How do I unstar a filter?”
“Can I remove a filter from favorites if it has since been made private?”
Tell an agent destructive · confirm first
Remove filter {id} from my favorites.
Unstar filter {id}.
PUT /rest/api/3/filter/{id}/favourite Add a filter to my favorites · Add filter as favorite #
Ask an LLM
“How do I star a filter so it shows in my favorites?”
“Can I favorite a filter someone else shared with my group?”
Tell an agent
Add filter {id} to my favorites.
Star filter {id}.
PUT /rest/api/3/filter/{id}/owner Change a filter's owner · Change filter owner #
Ask an LLM
“Can I hand ownership of a filter to another user?”
“What do I need to transfer a filter to a colleague who is leaving?”
Tell an agent
Make {accountId} the owner of filter {id}.
Transfer filter {id} to user {accountId}.

Documentation

📖
Documentation
https://developer.atlassian.com/cloud/jira/platform/rest/v3/intro/
📖
Authentication
https://developer.atlassian.com/cloud/jira/platform/rest/v3/intro/#authentication
📖
Documentation
https://developer.atlassian.com/cloud/jira/software/rest/intro/
📖
Documentation
https://developer.atlassian.com/cloud/jira/service-desk/rest/intro/
📖
APIReference
https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issues/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/jira/refs/heads/main/openapi/jira-filters-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/jira:jira-filters-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

jira-filters-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  contact:
    email: ecosystem@atlassian.com
  description: Jira Cloud platform REST API documentation
  license:
    name: Apache 2.0
    url: http://www.apache.org/licenses/LICENSE-2.0.html
  termsOfService: https://developer.atlassian.com/platform/marketplace/atlassian-developer-terms/
  title: Jira Cloud platform REST Filters API
  version: 1001.0.0-SNAPSHOT-82b018affa468e58f284fbe4df33536469d757df
servers:
- url: https://your-domain.atlassian.net
tags:


# --- truncated at 32 KB (143 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/jira/refs/heads/main/openapi/jira-filters-api-openapi.yml