Апдейт поля

Endpoint

PATCH /bot/tasks/{task_id}/items/{form_field_id}

Обновляет одно поле задачи по связке task_id + form_field_id.

Auth

Authorization: Bearer <token>
Content-Type: application/json

Path params

• task_id - ID задачи
• form_field_id - ID поля, которое нужно обновить

Минимальный пример update item

{
  "form_field_id": 101,
  "form_field_type": "TextField",
  "value": "Updated by bot"
}

Пример curl:

curl -X PATCH \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "form_field_id": 101,
    "form_field_type": "TextField",
    "value": "Updated by bot"
  }' \
  https://public-api.hcapp.ee/bot/tasks/5001/items/101

Поддерживаемые типы

• TextField
• TextareaField
• NumberField
• ChoiceField
• DateField
• DueDateField
• PhoneField
• EmailField
• FormField

TableField этим endpoint не обновляется.

Request body

• form_field_id
• form_field_type
• value
• linked_task_id для FormField

form_field_id передается и в path, и в body.
Фактическое поле для обновления выбирается по path parameter.

Примеры

Text field:

{
  "form_field_id": 101,
  "form_field_type": "TextField",
  "value": "Updated by bot"
}

Number field:

{
  "form_field_id": 102,
  "form_field_type": "NumberField",
  "value": "125.67891"
}

Choice field:

{
  "form_field_id": 103,
  "form_field_type": "ChoiceField",
  "value": ["done"]
}

Date field:

{
  "form_field_id": 104,
  "form_field_type": "DateField",
  "value": "2026-03-29T12:30:00Z"
}

Form field:

{
  "form_field_id": 105,
  "form_field_type": "FormField",
  "value": "5000",
  "linked_task_id": 5000
}

Response body

{
  "success": true,
  "error_message": null,
  "data": {
    "item_id": 7001,
    "form_field_id": 101,
    "form_field_type": "TextField",
    "name": "Title",
    "value": "Updated by bot",
    "float_value": null,
    "date_value": null,
    "linked_task_id": null
  }
}

Ошибки

• 404 Task not found
• 403 Form access not found
• 404 Form field not found
• 400 Field {id} type mismatch: expected ..., got ...
• 413 Payload too large. Max size is 32768 bytes
• 429 Rate limit exceeded. Retry after {seconds} seconds

Ограничения

• JSON payload до 32 KB
• TableField этим endpoint не обновляется