Updating a project through API: update_project


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
  • tags — project tags separated by commas (for example: tags=TAG1,TAG2)
    Tag names (if unique) or their IDs (available via get_project_tags method) are supported. Provided tags overwrite previously set ones. To add or remove tags selectively, use update_project_tags method

Parameters unavailable for updating:
  • email_user_from — project author email
  • text — project description
  • company — folder name, where the project is located

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

{
    "status": "ok",
    "data": {
        "id": "PROJECT_ID",
        "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",
"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, "tags": { "TAG_ID": "TAG_NAME_1", "TAG_ID": "TAG_NAME_2" }
    }
}