# 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](https://about/en/faq/api-projects.html#q1694) 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):&#x20;
* Assignee can:
* options.allow\_close — mark task as done
* options.allow\_give — transfer the responsibility&#x20;
* 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:\
  &#xNAN;_&#x6F;nly 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](https://about/en/faq/api-tags.html#q1690) method)

***

Sample JSON response

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

```json
{
    "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",
            ... ... ...
        }
    ]
}
```
