Создать поле задачи

Запрос позволяет создать глобальное поле задачи.

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

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

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

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

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

{
    "name":
    {
        "en": "Название на английском языке",
        "ru": "Название на русском языке"
    },
    "id": "global_field_key",
    "category": "0000000000000001********",
    "type": "ru.yandex.startrek.core.fields.StringFieldType"
}

Пример: Создать поле типа «Выпадающий список» с фиксированным набором строковых значений.

• Используется HTTP-метод POST.
• Тип поля: FixedListOptionsProvider.
• Значения в выпадающем списке: «первый элемент списка», «второй элемент списка», «третий элемент списка».

POST /v3/fields
Host: api.tracker.yandex.net
Authorization: OAuth <OAuth-токен>
X-Org-Id: <идентификатор_организации>

{
   "name":
   {
       "en": "Название на английском языке",
       "ru": "Название на русском языке"
   },
   "id": "myglobalfield",
   "category": "0000000000000003********",
   "type": "ru.yandex.startrek.core.fields.StringFieldType",
   "optionsProvider": {
       "type": "FixedListOptionsProvider",
       "values": [
           "первый элемент списка",
           "второй элемент списка",
           "третий элемент списка"
       ]
   }
}

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

 {
  "self": "https://api.tracker.yandex.net/v3/fields/global_field_key",
  "id": "global_field_key",
  "name": "Field name",
  "description": "Field description",
  "key": "global_field_key",
  "version": 1,
  "schema": {
      "type": "array",
      "items": "string",
      "required": false
  },
  "readonly": false,
  "options": true,
  "suggest": false,
  "optionsProvider": {
      "type": "FixedListOptionsProvider",
      "needValidation": true,
      "values": [
          "First item",
          "Second item",
          "Third item"
      ]
  },
  "queryProvider": {
      "type": "StringOptionalQueryProvider"
  },
  "order": 5,
  "category": {
      "self": "https://api.tracker.yandex.net/v3/fields/categories/0000000000000001********",
      "id": "0000000000000001********",
      "display": "Системные"
  },
  "type": "standard"
}