Projects

Sample update_project request

?action=update_project&id_project=PROJECT_ID

Updates selected project parameters

Required parameters:

• id_project — project ID

Optional parameters:

• email_manager — project manager email

• email_user_to — user email of a default task executive, additional possible values: ANY – "Anyone", NOONE or not specified – "Executive isn't assigned")

• members — member emails separated by commas, who will be added to the project team (use delete_project_members for removal)

• title — project name

• datestart — start date in DD.MM.YYYY format

• dateend — due date in DD.MM.YYYY format

• project restriction options ( 0/ 1 — to enable/disable):

• Assignee can:

• options.allow_close — mark task as done

• options.allow_give — transfer the responsibility

• options.allow_term — change the task terms

• options.allow_limit — change the estimates

• New task required fields PRO:

• options.require_term — terms

• options.require_tag — stages and labels

• options.require_limit — estimates

• options.require_hidden — visibility

• Users are not permitted PRO:

• options.deny_comments_edit — edit and delete comments

• options.deny_task_edit — edit and delete tasks

• options.deny_task_delete — delete tasks

• Adding costs PRO: only one parameter can be enabled from this sublist

• options.time_require — mark as done with costs only

• options.time_today — add for today only

• options.timer_only — add from timer only

• extra=options — project restriction options info

• max_time — time estimates

• max_money — financial estimates

Parameters unavailable for updating:

• email_user_from — project author email

• text — project description

• company — folder name, where the project is located

• tags — project tags (can be updated through update_project_tags method)

---

Sample JSON response

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

{
    "status": "ok",
    "data": [ 
        {
            "id": "PROJECT_ID_1",
            "name": "PROJECT_NAME",
            "page": "/project/PROJECT_ID/",
            "status": "active",
            "company": "FOLDER_NAME",
            "user_from": {
                "id": "USER_ID",
                "email": "USER_EMAIL",
                "name": "USER_NAME"
            },
            "user_to": {
                "id": "USER_ID",
                "email": "USER_EMAIL",
                "name": "USER_NAME"
            },
            "text": "PROJECT_TEXT",
            "date_added": "YYYY—MM—DD HH:II",
            "date_start": "YYYY—MM—DD",
            "date_end": "YYYY—MM—DD",
            "date_closed": "YYYY—MM—DD HH:II",
            "options": {
               "allow_close": 0..1,
               "allow_give": 0..1,
               "allow_term": 0..1,
               "allow_limit": 0..1,
               "require_term": 0..1,
               "require_tag": 0..1,
               "require_limit": 0..1,
               "require_hidden": 0..1,
               "deny_comments_edit": 0..1,
               "deny_task_edit": 0..1,
               "deny_task_delete": 0..1,
               "time_require": 0..1,
               "time_today": 0..1,
               "timer_only": 0..1
            },
            "max_time": 100,
            "max_money": 500,
            "users": [
                {
                    "id": "USER_ID",
                    "email": "USER_EMAIL",
                    "name": "USER_NAME"
                },
                {
                    "id": "USER_ID",
                    "email": "USER_EMAIL",
                    "name": "USER_NAME"
                },
                {
                    "id": "USER_ID",
                    "email": "USER_EMAIL",
                    "name": "USER_NAME"
                },
                {
                    "id": "USER_ID",
                    "email": "USER_EMAIL",
                    "name": "USER_NAME"
                }
            ]
        },
        {
            "id": "PROJECT_ID_2",
            "name": "PROJECT_NAME",
            ... ... ...
        }
    ]
}