Knowledge base - Updating a task through API: update

Sample update_task request

?action=update_task&id_task=TASK_ID&email_user_to=USER_EMAIL

Updates selected incomplete or completed (sub)task parameters

Required parameters:

id_task — task ID

Optional parameters:

email_user_to — task executive email, additional possible values: ANY – "Anyone", NOONE or not specified – "Executive isn't assigned"
priority — priority (value range: 0..10)
title — task name
datestart — start date in DD.MM.YYYY format
dateend — due date in DD.MM.YYYY format
dateclosed — closing date in DD.MM.YYYY format
max_time — time estimates
max_money — financial estimates
tags — task tags separated by commas (for example: tags=TAG1,TAG2)
Tag names (if unique) or their IDs (available via get_task_tags method) are supported. Only tags from sets added to the project are allowed.
Provided tags overwrite previously set ones. To add or remove tags selectively, use update_task_tags method

Parameters unavailable for editing:

email_user_from — task author
text — task description
todo — checklist
subscribe — users, who will be subscribed to the task
hidden — users, who will have access to this task, while it will be hidden for others

Sample JSON response

If the request succeeds, the response will contain ok status and the following data:

{
    "status": "ok",
    "data": {
        "id": "TASK_ID",
        "name": "TASK_NAME",
        "page": "/project/PROJECT_ID/TASK_ID/",
        "status": "active",
        "priority": "0..10",
        "user_from": {
            "id": "USER_ID",
            "email": "USER_EMAIL",
            "name": "USER_NAME"
        },
        "user_to": {
            "id": "USER_ID",
            "email": "USER_EMAIL",
            "name": "USER_NAME"
        },
        "project": {
            "id": "PROJECT_ID",
            "name": "PROJECT_NAME",
            "page": "/project/PROJECT_ID/"
        },
        "date_added": "YYYY-MM-DD HH:II",
        "date_start": "YYYY-MM-DD",
        "date_end": "YYYY-MM-DD",
        "max_time": 40,
        "max_money": 200,
        "tags": {
            "TAG_ID": "TAG_NAME_1",
            "TAG_ID": "TAG_NAME_2"
        }
    }
}

Updating a task through API: update_task