Create a filter

The request allows you to create a new issue filter.

https://api.tracker.yandex.net/v3/filters/

Request format

Before making a request, get access to the API.

To create a filter, use an HTTP request with the POST method. Specify the parameters in JSON format in the request body:

POST /v3/filters/
Host: api.tracker.yandex.net
Authorization: OAuth y0__xAbc******
Content-Type: application/json
X-Org-ID or X-Cloud-Org-ID: <organization_ID>

{
    "name": "<filter_name>",
    "filter": {
        "status": "open"
    }
}

Example 1: Create a filter with multiple conditions

• The HTTP POST method is used.
• A filter named "My Open Issues" is created.
• The filter object: selects issues based on two conditions simultaneously (logical AND):
  • Status — open issues (open)
  • Assignee — the current user (me())

POST /v3/filters/ HTTP/1.1
Host: api.tracker.yandex.net
Authorization: OAuth y0__xAbc******
Content-Type: application/json
X-Org-ID or X-Cloud-Org-ID: <organization_ID>

{
    "name": "My Open Issues",
    "filter": {
        "status": "open",
        "assignee": "me()"
    }
}

Example 2: Create a filter with a condition, sorting, and field selection

• The HTTP POST method is used.
• A filter named "Open Issues" is created.
• The filter object: selects only issues with the open status.
• The sorts parameter: results are sorted by creation date (newest first).
• The fields parameter: only three fields — key, summary, and status — will be displayed in the UI. Other issue fields will be hidden in the interface.

POST /v3/filters/ HTTP/1.1
Host: api.tracker.yandex.net
Authorization: OAuth y0__xAbc******
Content-Type: application/json
X-Org-ID or X-Cloud-Org-ID: <organization_ID>

{
    "name": "Open Issues",
    "filter": {
        "status": "open"
    },
    "sorts": [
        {
            "field": "created",
            "isAscending": false
        }
    ],
    "fields": ["key", "summary", "status"]
}

Response format

{
    "id": 12345,
    "self": "https://api.tracker.yandex.net/v3/filters/12345",
    "name": "My Open Issues",
    "filter": {
        "assignee": "me()",
        "status": "open"
    },
    "favorite": false,
    "permissions": {
        "READ": {
            "users": [],
            "groups": [
                {
                    "self": "https://api.tracker.yandex.net/v3/groups/5",
                    "id": "5",
                    "display": "All employees"
                }
            ],
            "roles": []
        },
        "WRITE": {
            "users": [
                {
                    "self": "https://api.tracker.yandex.net/v3/users/1234567890",
                    "id": "1234567890",
                    "display": "User Name",
                    "cloudUid": "ajevuhegoiuhfasjhiu",
                    "passportUid": 1234567890
                }
            ],
            "groups": [],
            "roles": []
        }
    },
    "owner": {
        "self": "https://api.tracker.yandex.net/v3/users/1234567890",
        "id": "1234567890",
        "display": "User Name",
        "cloudUid": "ajevuhegoiuhfasjhiu",
        "passportUid": 1234567890
    }
}