---
metadata:
  - name: generator
    content: Diplodoc Platform v5.54.2
  - property: og:type
    content: article
  - property: article:section
    content: Справочник API
  - property: og:title
    content: Параметры задач в запросах к API и ответах
  - property: article:tag
    content: Техническая инструкция
alternate:
  - https://yandex.ru/support/tracker/en/api-ref/issues/fields.md
  - https://yandex.ru/support/tracker/ru/api-ref/issues/fields.md
  - href: ru/api-ref/issues/fields.md
    type: text/markdown
    title: Markdown version
  - href: ../../llms.txt
    type: text/markdown
    title: llms.txt
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/support/tracker/ru/llms.txt


# Параметры задач в запросах к API и ответах

При работе с задачами через API вы можете использовать различные параметры для создания, редактирования и получения информации о задачах.

В этой документации описаны стандартные параметры задачи, которые доступны в Трекере по умолчанию, а также стандартные объекты, которые могут содержаться в задаче:

* [Параметры задачи в запросах к API](https://yandex.ru/support/tracker/ru/api-ref/issues/request-fields.md)
* [Параметры задачи в ответах на запросы](https://yandex.ru/support/tracker/ru/api-ref/issues/response-fields.md)

Помимо стандартных параметров, задачи могут содержать:
- Пользовательские глобальные поля, созданные в организации.
- Локальные поля, специфичные для конкретной очереди.

### Глобальные поля {#global}

Глобальные поля можно использовать в задачах во всех очередях Трекера. По умолчанию в Трекере доступны самые популярные поля задач.

Дополнительные глобальные поля  может создать администратор Трекера. [Как добавить в Трекер глобальное поле](https://yandex.ru/support/tracker/user/create-param.html#global-field).

Список всех глобальных полей можно посмотреть на странице [Настройки Трекера](https://tracker.yandex.ru/admin/fields).

### Локальные поля {#local}

Локальное поле можно использовать только в задачах той очереди, к которой оно привязано. Преимущество локальных полей в том, что владелец очереди может управлять такими полями без риска повлиять на процессы работы в других очередях. Пользователи, которые работают в других очередях, не будут видеть это поле в своих задачах.

Как использовать локальные поля, читайте в разделе [Локальные поля задач](https://yandex.ru/support/tracker/local-fields.html).

**Важные моменты при работе с локальными полями через API:**

- Идентификатор локального поля включает шестнадцатеричный префикс и ключ поля: `603fb94c38bbe658********--myfield`.

    Например, чтобы изменить значение локального поля задачи через API, в теле HTTP-запроса на редактирование задачи укажите идентификатор поля: `603fb94c38bbe658********--<ключ_поля>: "<новое_значение_локального_поля>"`. [Как редактировать задачу с помощью API](https://yandex.ru/support/tracker/ru/api-ref/issues/patch-issue.md)
- Убедитесь, что локальное поле принадлежит указанной очереди.
- Соблюдайте типы данных согласно схеме поля:
  - Для строковых полей используйте строки
  - Для числовых полей используйте числа
  - Для массивов пользователей используйте объекты с полем `id`
- Чтобы получить список локальных полей очереди, используйте запрос [Получить список локальных полей очереди](https://yandex.ru/support/tracker/ru/api-ref/queues/get-local-fields.md)
