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

{
  "id": 15,
  "name": "Summary",
  "type": "text",
  "value": "Printer does not print",
  "info": {
    "immutable_step": 1,
    "required_step": 1
  }
}

Запрос	id	name	type	value	info	parent_id	row_id
GET /forms
GET /forms/{form-id}
GET /forms/{form-id}/register
GET /tasks/{task-id}
POST /tasks/{task-id}/comments	*
POST /tasks	*

* Необходимо указать хотя бы один из этих параметров

catalog
Чтение:

"value": {
    "item_id": 80797460,
    "item_ids": [
        80797460
    ],
    "headers": [
        "Vendor Name",
        "Vendor Code"
    ],
    "values": [
        "GE",
        "123"
    ],
    "rows": [
        [
            "GE",
            "123"
        ]
    ]
}
      

"value": {
    "item_ids": [
        80797460,
        80797461
    ],
    "headers": [
        "Vendor Name",
        "Vendor Code"
    ],
    "rows": [
        [
            "GE",
            "123"
        ],
        [
            "VN",
            "321"
        ]
    ]
}

Запись:

"value": {
  "item_id": 23
}

"value": {
  "item_name": "GE"
}

"value": {
    "item_ids": [
        80797460,
        80797461
    ]
}

"value": {
    "item_names": [
        "GE",
        "VN"
    ]
}

file
Чтение:

"value": [{
  "id": 17563,
  "name": "S15294-16.pdf",
  "size": 541512,
  "md5": "202cb962ac59075b964b07152d234b70",
  "url": "https://api.pyrus.com/files/17563",
  "version": 2,
  "root_id": 17562
}]

Запись:

person
Чтение:

"value": {
  "id": 1730,
  "first_name": "Jane",
  "last_name": "Doe",
  "email": "Jane.Doe@gmail.com",
  "type": "user"
}

Запись:

"value": {
  "id": 1730,
}

"value": {
  "email": "Jane.Doe@gmail.com",
}

author (только для чтения)
Чтение:

"value": {
  "id": 1730,
  "first_name": "Jane",
  "last_name": "Doe",
  "email": "Jane.Doe@gmail.com",
  "type": "user"
}

table
Чтение:

"value": [
    {
    "row_id": 0,
    "cells": [
      {
        "id": 6,
        "type": "date",
        "name": "Date",
        "value": "2017-08-26",
        "parent_id": 5,
        "row_id": 0,
      },
      {
        "id": 9,
        "type": "money",
        "name": "Amount",
        "value": 10000,
        "parent_id": 5,
        "row_id": 0,
      }
    ]
  },
  {
    "row_id": 1,
    "cells": [
    {
      "id": "6",
      "type": "date",
      "name": "Date",
      "value": "2017-08-27",
      "parent_id": 5,
      "row_id": 1,
    },
    {
      "id": 9,
      "type": "money",
      "name": "Amount",
      "value": 306.25,
      "parent_id": 5,
      "row_id": 1,
    }
  ]}
]

Запись:

"value": [{
    "row_id": 0,
    "delete": true
  },
  {
  "row_id": 1,
  "cells": [
    {
      "id": 9,
      "value": 351.25
    },
    {
      "id": 6,
      "value": "2017-08-21"
    }
  ]
}]

multiple_choice
Чтение:

"value": {
  "choice_ids": [5],
  "choice_names": ["Yes"]
  "fields": [
    {
      "id": 6,
      "type": "text",
      "name": "Comment",
      "value": "Additional information about choice",
      "parent_id": 4
    },
    {
      "id": 9,
      "type": "number",
      "name": "Quantity",
      "value": 15,
      "parent_id": 4
    }
  ]
}

Запись:

"value": {
    "choice_ids": [5]
    "fields": [
      {
        "id": 9,
        "value": 1
      }
    ]
  }

title
Чтение:

"value": {
  checkmark: "checked",
  "fields": [
    {
      "id": "3",
      "type": "date",
      "name": "Date",
      "value": "2017-08-19",
      "parent_id": 2
    },
    {
      "id": "4",
      "type": "text",
      "name": "Description",
      "value": "My issue",
      "parent_id": 2
    }
  ]
}

Запись:

"value": {
  "fields": [
    {
      "id": 4,
      "value": "It is not an issue"
    }
  ]
}

form_link
Чтение:

"value": {
  "task_ids": [1573],
  "subject": "Expense report"
}

Запись:

"value": {
  "task_ids" : [1753]
}

project (устарело, только для чтения)
Чтение:

"value": {
  "projects: [
    {
      "id": 1,
      "name": "Root Project"
    },
    {
      "id": 3,
      "name": "Child Project",
      "parent": {
        "id": 2,
        "name": "Another root project"
      }
    }
  ]
}

Объект info может содержать 2 ключа для всех типов полей:

• required_step — указывает номер шага, начиная с которого поле становится обязательным для заполнения;
• immutable_step — указывает номер шага, начиная с которого пользователь не может изменять значение поля.

Нумерация шагов начитается с единицы.

Также объект info может содержать информацию о user_id из поля типа Код и о том, что поле включается в заголовок задачи по форме.

Помимо указанных ключей, объект info в зависимости от типа будет содержать один из дополнительных ключей, описанных ниже:

"options": [
  {
    "choice_id": 0,
    "choice_value": "Not Set"
  },
  {
    "choice_id": 1,
    "choice_value": "Yes",
    "fields": {
      "id": 4,
      "type": "text",
      "name": "Reason",
      "parent_id": 3,
    }
  },
  {
    "choice_id": 2,
    "choice_value": "No",
  },
  {
    "choice_id": 3,
    "choice_value": "MayBe",
    "deleted": true
  }
]

"catalog_id": 165

"columns": [
  {
    "id": 9,
    "type": "money",
    "name": "Amount",
    "parent_id": 5,
  },
  {
    "id": 6,
    "type": "date",
    "name": "Date",
    "parent_id": 5,
  }
]

"fields": [
  {
    "id": 9,
    "type": "money",
    "name": "Amount",
    "parent_id": 5,
  },
  {
    "id": 6,
    "type": "date",
    "name": "Date",
    "parent_id": 5,
  }
]

"form_id": 1453

"decimal_places": 5

"multiple_choice": true