{"_id":"554a7e9d6b448d0d00646b92","parentDoc":null,"__v":9,"editedParams":true,"version":{"_id":"5548466bd2c8410d006c2146","project":"5548466bd2c8410d006c2143","__v":8,"createdAt":"2015-05-05T04:26:19.796Z","releaseDate":"2015-05-05T04:26:19.796Z","categories":["5548466cd2c8410d006c2147","554a69ba0b54d30d007fe128","554a7f3338e3620d0082192e","5565162e03b6710d00916942","55651a0c65a1130d00400c2b","55651d4565a1130d00400c2f","55651e0165a1130d00400c32","5565217903b6710d0091695f"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"category":{"_id":"554a69ba0b54d30d007fe128","project":"5548466bd2c8410d006c2143","pages":["554a69ca156a480d00e2924a","554a69d40b54d30d007fe129","554a6c8258f5650d00ae440d","554a6c8f58f5650d00ae4410","554a6c990b54d30d007fe131","554a7c0e38e3620d00821920","554a7e9d6b448d0d00646b92","554a7ea838e3620d00821929","554a7f016b448d0d00646b94","5575c1dbacd0472d000ac9ba"],"version":"5548466bd2c8410d006c2146","__v":10,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-05-06T19:21:30.961Z","from_sync":false,"order":1,"slug":"projects","title":"Projects"},"editedParams2":true,"project":"5548466bd2c8410d006c2143","user":"55484649b2581a0d00913ff3","updates":[],"next":{"pages":[],"description":""},"createdAt":"2015-05-06T20:50:37.977Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[{"status":200,"language":"json","code":"{\n\t\tstatus: \"Okay\",\n    project:{\n        \"description\": null,\n        \"shortName\": \"TAPIa30dfsdfsdf\",\n        \"rate\": 111.00,\n        \"budget\": 5501.00,\n        \"manager\": {\"id\": 1801},\n        \"customer\": {\"id\": 3070},\n        \"priority\": {\"id\": 16169},\n        \"status\": {\"id\": 4638},\n        \"chargeCode\": null,\n        \"name\": \"TEST3004\"\n    }\n}","name":""}]},"settings":"","examples":{"codes":[{"code":"var project = {\n    \"description\": null,\n    \"shortName\": \"TESTAPa\",\n    \"rate\": 111.00,\n    \"budget\": 5501.00,\n    \"manager\": {\n        \"id\": 1801\n    },\n    \"customer\": {\n          \"id\": 3070\n     },\n    \"priority\": {\n          \"id\": 16169\n     },\n     \"status\": {\n           \"id\": 4638\n     },\n     \"chargeCode\": null,\n     \"name\": \"TESTAPIa\"\n}\n$.ajax({\n\t\ttype: \"PUT\", \n\t\turl: \"/api/v1/projects/\"+projectId+\".json\", \n\t\tcontentType: 'application/json', \n\t\tdataType: \"json\", \n\t\tsuccess: worked,\n\t\tdata: JSON.stringify(project),\n\t\theaders: { apiKey: apiKey }\n });","language":"javascript"}]},"method":"put","auth":"required","params":[{"_id":"5565130c65a1130d00400c13","ref":"","in":"body","required":true,"desc":"The name of the project.","default":"","type":"string","name":"name"},{"_id":"5565130c65a1130d00400c12","ref":"","in":"body","required":false,"desc":"Ths shortname of your project. Maximum 7 characters.","default":"","type":"string","name":"shortName"},{"_id":"5565130c65a1130d00400c11","ref":"","in":"body","required":false,"desc":"The description of your project. Maximum 1000 characters.","default":"","type":"string","name":"description"},{"_id":"5565130c65a1130d00400c10","ref":"","in":"body","required":false,"desc":"Decimal, The project's default rate per hour.","default":"0","type":"double","name":"rate"},{"_id":"5565130c65a1130d00400c0f","ref":"","in":"body","required":false,"desc":"Decimal.  The budget for the project.","default":"0","type":"double","name":"budget"},{"_id":"5565130c65a1130d00400c07","ref":"","in":"body","required":false,"desc":"{id: chargeCodeId}. The charge code Id for the project. Retrieve using project data endpoint: /api/v1/ProjectData/customFields","default":"","type":"int","name":"chargeCode"},{"_id":"5565130c65a1130d00400c0e","ref":"","in":"body","required":false,"desc":"{id: statusId}. The project status Id. Retrieve using project data endpoint: /api/v1/ProjectData/statuses","default":"","type":"int","name":"status"},{"_id":"5565130c65a1130d00400c0d","ref":"","in":"body","required":false,"desc":"{id: priorityId}. The project priority Id. Retrieve using project data endpoint: /api/v1/ProjectData/priorities","default":"","type":"int","name":"priority"},{"_id":"5565130c65a1130d00400c0c","ref":"","in":"body","required":false,"desc":"{id: managerId}. The project manager Id for the project. Retrieve using project data endpoint: /api/v1/ProjectData/managers","default":"","type":"int","name":"manager"},{"_id":"5565130c65a1130d00400c0b","ref":"","in":"body","required":false,"desc":"{id: custom1Id}.  Retrieve using project data endpoint: /api/v1/ProjectData/customFields","default":"","type":"int","name":"custom1"},{"_id":"5565130c65a1130d00400c0a","ref":"","in":"body","required":false,"desc":"{id: custom2Id}. Retrieve using pproject data endpoint: /api/v1/ProjectData/customFields","default":"","type":"int","name":"custom2"},{"_id":"5565130c65a1130d00400c09","ref":"","in":"body","required":false,"desc":"{id: custom3Id}.  Retrieve using project data endpoint: /api/v1/ProjectData/customFields","default":"","type":"int","name":"custom3"},{"_id":"5565130c65a1130d00400c08","ref":"","in":"body","required":false,"desc":"{id: custom4Id}. Retrieve using project data endpoint: /api/v1/ProjectData/customFields","default":"","type":"int","name":"custom4"}],"url":"/projects/{projectId}.json"},"isReference":false,"order":5,"body":"Updates a given project with the supplied data.","excerpt":"A Project resource represents a planned and track-able project within ProjectManager.com.\n\nUse this API to update a single Project within ProjectManager.com.","slug":"create-a-project","type":"endpoint","title":"Update a Project"}

putUpdate a Project

A Project resource represents a planned and track-able project within ProjectManager.com. Use this API to update a single Project within ProjectManager.com.

Definition

{{ api_url }}{{ page_api_url }}

Parameters

Body Params

name:
required
string
The name of the project.
shortName:
string
Ths shortname of your project. Maximum 7 characters.
description:
string
The description of your project. Maximum 1000 characters.
rate:
double0
Decimal, The project's default rate per hour.
budget:
double0
Decimal. The budget for the project.
chargeCode:
integer
{id: chargeCodeId}. The charge code Id for the project. Retrieve using project data endpoint: /api/v1/ProjectData/customFields
status:
integer
{id: statusId}. The project status Id. Retrieve using project data endpoint: /api/v1/ProjectData/statuses
priority:
integer
{id: priorityId}. The project priority Id. Retrieve using project data endpoint: /api/v1/ProjectData/priorities
manager:
integer
{id: managerId}. The project manager Id for the project. Retrieve using project data endpoint: /api/v1/ProjectData/managers
custom1:
integer
{id: custom1Id}. Retrieve using project data endpoint: /api/v1/ProjectData/customFields
custom2:
integer
{id: custom2Id}. Retrieve using pproject data endpoint: /api/v1/ProjectData/customFields
custom3:
integer
{id: custom3Id}. Retrieve using project data endpoint: /api/v1/ProjectData/customFields
custom4:
integer
{id: custom4Id}. Retrieve using project data endpoint: /api/v1/ProjectData/customFields

Examples


Result Format


Documentation

Updates a given project with the supplied data.