UpdateStatus
This service is used to perform the same actions as the Update Status Suitelet, which is accessed via a TaskFlow Project record. The service will allow you to set a Status for a project (referencing a Status Option id). It also optionally allows you to set the Task and the Assigned User. If you don't explicitly set Task and/or Assigned User, the system will default them based on the TaskFlow definition. In most cases you would just set Status.
NOTE: There are several statuses that are set automatically based on the dates of the Primary Deliverable. Please make sure you are aware of all users processes (i.e. are they setting the status or are they setting dates) before using this service.
HTTP: POST
Updates the Status, Current Task, and Assigned User of a project.
Base URL
https://{{realm}}.restlets.api.netsuite.com/app/site/hosting/restlet.nl?script=customscript_prac_api_updatestatus&deploy=customdeploy_prac_api_updatestatus_v1
Required URL Parameters
| Name | Value | Notes |
|---|---|---|
| script | customscript_prac_api_updatestatus | |
| deploy | customdeploy_prac_api_updatestatus_v1 |
Optional URL Parameters
| Name | Value | Notes |
|---|---|---|
Payload
The payload passed in the POST request should be JSON format. It must contain a value for projectid (the id of the Project being updated) and must contain the status property.
Example of just setting status:
{
"projectid": 1234,
"statusoption": 8
}
Example of setting status to an on hold status:
{
"projectid": 1234,
"statusoption": 15,
"onholdreason": 1
}
Example of setting status, task and assigned to explicitly:
{
"projectid": 1234,
"statusoption": 15,
"task": 8,
"assigned": 55
}
Response Information
Returns the data that was set, including any values defaulted from the TaskFlow definition.