Создать фильтр

Запрос позволяет создать новый фильтр задач.

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

Формат запроса

Перед выполнением запроса получите доступ к API.

Чтобы создать фильтр, используйте HTTP-запрос с методом POST. В теле запроса укажите параметры в формате JSON:

POST /v3/filters/
Host: api.tracker.yandex.net
Authorization: OAuth y0__xAbc******
X-Org-ID или X-Cloud-Org-ID: <идентификатор_организации>

{
    "name": "<название_фильтра>",
    "filter": {
        "status": "open"
    }
}

Пример 1: Создать фильтр с несколькими условиями

• Используется HTTP-метод POST.
• Создается фильтр с названием «Мои открытые задачи».
• Объект filter: отбирает задачи по двум условиям одновременно (логическое И):
  • Статус — открытые задачи (open)
  • Исполнитель — текущий пользователь (me())

POST /v3/filters/ HTTP/1.1
Host: api.tracker.yandex.net
Authorization: OAuth y0__xAbc******
X-Org-ID или X-Cloud-Org-ID: <идентификатор_организации>

{
    "name": "Мои открытые задачи",
    "filter": {
        "status": "open",
        "assignee": "me()"
    }
}

Пример 2: Создать фильтр с условием, сортировкой и выбором полей

• Используется HTTP-метод POST.
• Создается фильтр с названием «Открытые задачи».
• Объект filter: отбирает только задачи со статусом open.
• Параметр sorts: результаты сортируются по дате создания (от новых к старым).
• Параметр fields: в UI будут отображаться только три поля — key, summary и status. Остальные поля задачи будут скрыты в интерфейсе.

POST /v3/filters/ HTTP/1.1
Host: api.tracker.yandex.net
Authorization: OAuth y0__xAbc******
X-Org-ID или X-Cloud-Org-ID: <идентификатор_организации>

{
    "name": "Открытые задачи",
    "filter": {
        "status": "open"
    },
    "sorts": [
        {
            "field": "created",
            "isAscending": false
        }
    ],
    "fields": ["key", "summary", "status"]
}

Формат ответа

{
    "id": 12345,
    "self": "https://api.tracker.yandex.net/v3/filters/12345",
    "name": "Мои открытые задачи",
    "filter": {
        "assignee": "me()",
        "status": "open"
    },
    "favorite": false,
    "permissions": {
        "READ": {
            "users": [],
            "groups": [
                {
                    "self": "https://api.tracker.yandex.net/v3/groups/5",
                    "id": "5",
                    "display": "Все сотрудники"
                }
            ],
            "roles": []
        },
        "WRITE": {
            "users": [
                {
                    "self": "https://api.tracker.yandex.net/v3/users/1234567890",
                    "id": "1234567890",
                    "display": "Имя Фамилия",
                    "cloudUid": "ajevuhegoiuhfasjhiu",
                    "passportUid": 1234567890
                }
            ],
            "groups": [],
            "roles": []
        }
    },
    "owner": {
        "self": "https://api.tracker.yandex.net/v3/users/1234567890",
        "id": "1234567890",
        "display": "Имя Фамилия",
        "cloudUid": "ajevuhegoiuhfasjhiu",
        "passportUid": 1234567890
    }
}