Update item

Endpoint

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

Updates a single task field using task_id + form_field_id.

Auth

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

Path params

• task_id - task ID
• form_field_id - field ID to update

Minimal update item example

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

Example 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

Supported types

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

TableField is not updated through this endpoint.

Request body

• form_field_id
• form_field_type
• value
• linked_task_id for FormField

form_field_id appears both in the path and in the body.
The actual target field is selected by the path parameter.

Examples

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
  }
}

Errors

• 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

Limits

• JSON payload up to 32 KB
• TableField is not updated through this endpoint