Atlassian The Jira Cloud platform REST API — Filters

naftiko: 1.0.0-alpha2
info:
  label: Atlassian The Jira Cloud platform REST API — Filters
  description: 'Atlassian The Jira Cloud platform REST API — Filters. 13 operations. Lead operation: Atlassian Create Filter.
    Self-contained Naftiko capability covering one Atlassian business surface.'
  tags:
  - Atlassian
  - Filters
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    ATLASSIAN_API_KEY: ATLASSIAN_API_KEY
capability:
  consumes:
  - type: http
    namespace: jira-filters
    baseUri: https://your-domain.atlassian.net
    description: Atlassian The Jira Cloud platform REST API — Filters business capability. Self-contained, no shared references.
    resources:
    - name: rest-api-3-filter
      path: /rest/api/3/filter
      operations:
      - name: atlassiancreatefilter
        method: POST
        description: Atlassian Create Filter
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: expand
          in: query
          type: string
          description: 'Use [expand](#expansion) to include additional information about filter in the response. This parameter
            accepts a comma-separated list. Expand options include:'
        - name: overrideSharePermissions
          in: query
          type: boolean
          description: 'EXPERIMENTAL: Whether share permissions are overridden to enable filters with any share permissions
            to be created. Available to users with *Administer Jira* [gl'
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: rest-api-3-filter-favourite
      path: /rest/api/3/filter/favourite
      operations:
      - name: atlassiangetfavouritefilters
        method: GET
        description: Atlassian Get Favorite Filters
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: expand
          in: query
          type: string
          description: 'Use [expand](#expansion) to include additional information about filter in the response. This parameter
            accepts a comma-separated list. Expand options include:'
    - name: rest-api-3-filter-my
      path: /rest/api/3/filter/my
      operations:
      - name: atlassiangetmyfilters
        method: GET
        description: Atlassian Get My Filters
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: expand
          in: query
          type: string
          description: 'Use [expand](#expansion) to include additional information about filter in the response. This parameter
            accepts a comma-separated list. Expand options include:'
        - name: includeFavourites
          in: query
          type: boolean
          description: Include the user's favorite filters in the response.
    - name: rest-api-3-filter-search
      path: /rest/api/3/filter/search
      operations:
      - name: atlassiangetfilterspaginated
        method: GET
        description: Atlassian Search For Filters
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: filterName
          in: query
          type: string
          description: String used to perform a case-insensitive partial match with `name`.
        - name: accountId
          in: query
          type: string
          description: User account ID used to return filters with the matching `owner.accountId`. This parameter cannot be
            used with `owner`.
        - name: owner
          in: query
          type: string
          description: This parameter is deprecated because of privacy changes. Use `accountId` instead. See the [migration
            guide](https://developer.atlassian.com/cloud/jira/platform/
        - name: groupname
          in: query
          type: string
          description: 'As a group''s name can change, use of `groupId` is recommended to identify a group. Group name used
            to returns filters that are shared with a group that matches '
        - name: groupId
          in: query
          type: string
          description: 'Group ID used to returns filters that are shared with a group that matches `sharePermissions.group.groupId`.
            This parameter cannot be used with the `groupname` '
        - name: projectId
          in: query
          type: integer
          description: Project ID used to returns filters that are shared with a project that matches `sharePermissions.project.id`.
        - name: id
          in: query
          type: array
          description: The list of filter IDs. To include multiple IDs, provide an ampersand-separated list. For example,
            `id=10000&id=10001`. Do not exceed 200 filter IDs.
        - name: orderBy
          in: query
          type: string
          description: '[Order](#ordering) the results by a field:'
        - name: startAt
          in: query
          type: integer
          description: The index of the first item to return in a page of results (page offset).
        - name: maxResults
          in: query
          type: integer
          description: The maximum number of items to return per page.
        - name: expand
          in: query
          type: string
          description: 'Use [expand](#expansion) to include additional information about filter in the response. This parameter
            accepts a comma-separated list. Expand options include:'
        - name: overrideSharePermissions
          in: query
          type: boolean
          description: 'EXPERIMENTAL: Whether share permissions are overridden to enable filters with any share permissions
            to be returned. Available to users with *Administer Jira* [g'
    - name: rest-api-3-filter-id
      path: /rest/api/3/filter/{id}
      operations:
      - name: atlassiandeletefilter
        method: DELETE
        description: Atlassian Delete Filter
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: integer
          description: The ID of the filter to delete.
          required: true
      - name: atlassiangetfilter
        method: GET
        description: Atlassian Get Filter
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: integer
          description: The ID of the filter to return.
          required: true
        - name: expand
          in: query
          type: string
          description: 'Use [expand](#expansion) to include additional information about filter in the response. This parameter
            accepts a comma-separated list. Expand options include:'
        - name: overrideSharePermissions
          in: query
          type: boolean
          description: 'EXPERIMENTAL: Whether share permissions are overridden to enable filters with any share permissions
            to be returned. Available to users with *Administer Jira* [g'
      - name: atlassianupdatefilter
        method: PUT
        description: Atlassian Update Filter
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: integer
          description: The ID of the filter to update.
          required: true
        - name: expand
          in: query
          type: string
          description: 'Use [expand](#expansion) to include additional information about filter in the response. This parameter
            accepts a comma-separated list. Expand options include:'
        - name: overrideSharePermissions
          in: query
          type: boolean
          description: 'EXPERIMENTAL: Whether share permissions are overridden to enable the addition of any share permissions
            to filters. Available to users with *Administer Jira* [gl'
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: rest-api-3-filter-id-columns
      path: /rest/api/3/filter/{id}/columns
      operations:
      - name: atlassianresetcolumns
        method: DELETE
        description: Atlassian Reset Columns
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: integer
          description: The ID of the filter.
          required: true
      - name: atlassiangetcolumns
        method: GET
        description: Atlassian Get Columns
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: integer
          description: The ID of the filter.
          required: true
      - name: atlassiansetcolumns
        method: PUT
        description: Atlassian Set Columns
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: integer
          description: The ID of the filter.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: rest-api-3-filter-id-favourite
      path: /rest/api/3/filter/{id}/favourite
      operations:
      - name: atlassiandeletefavouriteforfilter
        method: DELETE
        description: Atlassian Remove Filter As Favorite
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: integer
          description: The ID of the filter.
          required: true
        - name: expand
          in: query
          type: string
          description: 'Use [expand](#expansion) to include additional information about filter in the response. This parameter
            accepts a comma-separated list. Expand options include:'
      - name: atlassiansetfavouriteforfilter
        method: PUT
        description: Atlassian Add Filter As Favorite
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: integer
          description: The ID of the filter.
          required: true
        - name: expand
          in: query
          type: string
          description: 'Use [expand](#expansion) to include additional information about filter in the response. This parameter
            accepts a comma-separated list. Expand options include:'
    - name: rest-api-3-filter-id-owner
      path: /rest/api/3/filter/{id}/owner
      operations:
      - name: atlassianchangefilterowner
        method: PUT
        description: Atlassian Change Filter Owner
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: integer
          description: The ID of the filter to update.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    authentication:
      type: bearer
      token: '{{env.ATLASSIAN_API_KEY}}'
  exposes:
  - type: rest
    namespace: jira-filters-rest
    port: 8080
    description: REST adapter for Atlassian The Jira Cloud platform REST API — Filters. One Spectral-compliant resource per
      consumed operation, prefixed with /v1.
    resources:
    - path: /v1/api/3/filter
      name: rest-api-3-filter
      description: REST surface for rest-api-3-filter.
      operations:
      - method: POST
        name: atlassiancreatefilter
        description: Atlassian Create Filter
        call: jira-filters.atlassiancreatefilter
        with:
          expand: rest.expand
          overrideSharePermissions: rest.overrideSharePermissions
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/3/filter/favourite
      name: rest-api-3-filter-favourite
      description: REST surface for rest-api-3-filter-favourite.
      operations:
      - method: GET
        name: atlassiangetfavouritefilters
        description: Atlassian Get Favorite Filters
        call: jira-filters.atlassiangetfavouritefilters
        with:
          expand: rest.expand
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/3/filter/my
      name: rest-api-3-filter-my
      description: REST surface for rest-api-3-filter-my.
      operations:
      - method: GET
        name: atlassiangetmyfilters
        description: Atlassian Get My Filters
        call: jira-filters.atlassiangetmyfilters
        with:
          expand: rest.expand
          includeFavourites: rest.includeFavourites
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/3/filter/search
      name: rest-api-3-filter-search
      description: REST surface for rest-api-3-filter-search.
      operations:
      - method: GET
        name: atlassiangetfilterspaginated
        description: Atlassian Search For Filters
        call: jira-filters.atlassiangetfilterspaginated
        with:
          filterName: rest.filterName
          accountId: rest.accountId
          owner: rest.owner
          groupname: rest.groupname
          groupId: rest.groupId
          projectId: rest.projectId
          id: rest.id
          orderBy: rest.orderBy
          startAt: rest.startAt
          maxResults: rest.maxResults
          expand: rest.expand
          overrideSharePermissions: rest.overrideSharePermissions
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/3/filter/{id}
      name: rest-api-3-filter-id
      description: REST surface for rest-api-3-filter-id.
      operations:
      - method: DELETE
        name: atlassiandeletefilter
        description: Atlassian Delete Filter
        call: jira-filters.atlassiandeletefilter
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
      - method: GET
        name: atlassiangetfilter
        description: Atlassian Get Filter
        call: jira-filters.atlassiangetfilter
        with:
          id: rest.id
          expand: rest.expand
          overrideSharePermissions: rest.overrideSharePermissions
        outputParameters:
        - type: object
          mapping: $.
      - method: PUT
        name: atlassianupdatefilter
        description: Atlassian Update Filter
        call: jira-filters.atlassianupdatefilter
        with:
          id: rest.id
          expand: rest.expand
          overrideSharePermissions: rest.overrideSharePermissions
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/3/filter/{id}/columns
      name: rest-api-3-filter-id-columns
      description: REST surface for rest-api-3-filter-id-columns.
      operations:
      - method: DELETE
        name: atlassianresetcolumns
        description: Atlassian Reset Columns
        call: jira-filters.atlassianresetcolumns
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
      - method: GET
        name: atlassiangetcolumns
        description: Atlassian Get Columns
        call: jira-filters.atlassiangetcolumns
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
      - method: PUT
        name: atlassiansetcolumns
        description: Atlassian Set Columns
        call: jira-filters.atlassiansetcolumns
        with:
          id: rest.id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/3/filter/{id}/favourite
      name: rest-api-3-filter-id-favourite
      description: REST surface for rest-api-3-filter-id-favourite.
      operations:
      - method: DELETE
        name: atlassiandeletefavouriteforfilter
        description: Atlassian Remove Filter As Favorite
        call: jira-filters.atlassiandeletefavouriteforfilter
        with:
          id: rest.id
          expand: rest.expand
        outputParameters:
        - type: object
          mapping: $.
      - method: PUT
        name: atlassiansetfavouriteforfilter
        description: Atlassian Add Filter As Favorite
        call: jira-filters.atlassiansetfavouriteforfilter
        with:
          id: rest.id
          expand: rest.expand
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/3/filter/{id}/owner
      name: rest-api-3-filter-id-owner
      description: REST surface for rest-api-3-filter-id-owner.
      operations:
      - method: PUT
        name: atlassianchangefilterowner
        description: Atlassian Change Filter Owner
        call: jira-filters.atlassianchangefilterowner
        with:
          id: rest.id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: jira-filters-mcp
    port: 9090
    transport: http
    description: MCP adapter for Atlassian The Jira Cloud platform REST API — Filters. One tool per consumed operation, routed
      inline through this capability's consumes block.
    tools:
    - name: atlassian-create-filter
      description: Atlassian Create Filter
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: jira-filters.atlassiancreatefilter
      with:
        expand: tools.expand
        overrideSharePermissions: tools.overrideSharePermissions
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: atlassian-get-favorite-filters
      description: Atlassian Get Favorite Filters
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: jira-filters.atlassiangetfavouritefilters
      with:
        expand: tools.expand
      outputParameters:
      - type: object
        mapping: $.
    - name: atlassian-get-my-filters
      description: Atlassian Get My Filters
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: jira-filters.atlassiangetmyfilters
      with:
        expand: tools.expand
        includeFavourites: tools.includeFavourites
      outputParameters:
      - type: object
        mapping: $.
    - name: atlassian-search-filters
      description: Atlassian Search For Filters
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: jira-filters.atlassiangetfilterspaginated
      with:
        filterName: tools.filterName
        accountId: tools.accountId
        owner: tools.owner
        groupname: tools.groupname
        groupId: tools.groupId
        projectId: tools.projectId
        id: tools.id
        orderBy: tools.orderBy
        startAt: tools.startAt
        maxResults: tools.maxResults
        expand: tools.expand
        overrideSharePermissions: tools.overrideSharePermissions
      outputParameters:
      - type: object
        mapping: $.
    - name: atlassian-delete-filter
      description: Atlassian Delete Filter
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: jira-filters.atlassiandeletefilter
      with:
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.
    - name: atlassian-get-filter
      description: Atlassian Get Filter
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: jira-filters.atlassiangetfilter
      with:
        id: tools.id
        expand: tools.expand
        overrideSharePermissions: tools.overrideSharePermissions
      outputParameters:
      - type: object
        mapping: $.
    - name: atlassian-update-filter
      description: Atlassian Update Filter
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: jira-filters.atlassianupdatefilter
      with:
        id: tools.id
        expand: tools.expand
        overrideSharePermissions: tools.overrideSharePermissions
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: atlassian-reset-columns
      description: Atlassian Reset Columns
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: jira-filters.atlassianresetcolumns
      with:
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.
    - name: atlassian-get-columns
      description: Atlassian Get Columns
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: jira-filters.atlassiangetcolumns
      with:
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.
    - name: atlassian-set-columns
      description: Atlassian Set Columns
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: jira-filters.atlassiansetcolumns
      with:
        id: tools.id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: atlassian-remove-filter-favorite
      description: Atlassian Remove Filter As Favorite
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: jira-filters.atlassiandeletefavouriteforfilter
      with:
        id: tools.id
        expand: tools.expand
      outputParameters:
      - type: object
        mapping: $.
    - name: atlassian-add-filter-favorite
      description: Atlassian Add Filter As Favorite
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: jira-filters.atlassiansetfavouriteforfilter
      with:
        id: tools.id
        expand: tools.expand
      outputParameters:
      - type: object
        mapping: $.
    - name: atlassian-change-filter-owner
      description: Atlassian Change Filter Owner
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: jira-filters.atlassianchangefilterowner
      with:
        id: tools.id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.