Solutions
worksection
beta
help
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):
- 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
- options.require_term — terms
- options.require_tag — stages and labels
- options.require_limit — estimates
- options.require_hidden — visibility
- options.deny_comments_edit — edit and delete comments
- options.deny_task_edit — edit and delete tasks
- options.deny_task_delete — delete tasks
- 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
Assignee can:
New task required fields PRO:
Users are not permitted PRO:
Adding costs PRO:
only one parameter can be enabled from this sublist
only one parameter can be enabled from this sublist
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" }}}
Leave your review
Did this article help you?
Glad we could help! What was helpful?
Sorry this didn't help. What went wrong?