Recost Project for Manual Activity Sheet
Post /ws/rest/service/v2/activity/sheet/recost
Purpose
Recost Project for Manual/System Activity Sheet in a specified Unifier Shell based on project_number and activitysheetName provided in the payload for the API.
This POST service includes recosting of Current Manual/System Activity Sheet data.
Prerequisites
Ensure you have:
- created the Unifier Essentials shell
- the required Activity Sheet Services permissions under Activity Manager
- the manual/system activity sheet exists.
Request Format
Send an API request as a JSON Map with the following structure:
{
"options":{"project_number": "<value>",
"data":[{"activitySheetName" : "<value>"},
"activitySheetType": "<value>"
or
{"sourceProjectId" : "<value>",
"activitySheetType": "<value>",
"projectType": "<value>"
]}
Request Parameters - Options Map
Specify the following parameter in the Options JSON map:
Request Parameter | Required? | Data Type | Description |
|---|---|---|---|
project_number | Yes | String | A valid 'Active' shell number where the baseline schedule is to be created for a manual activity sheet. |
Request Parameters - Data Map
Specify the following parameters in Data []:
Request Parameter | Required? | Data Type | Description |
|---|---|---|---|
activitySheetType | Yes | String | Specify the activity sheet type. Valid values include: "system", "manual". For Primavera Cloud integrations/P6, specify "system" to insert data into the System Activity Sheet. |
activitySheetName | Yes, if "activitySheetType" is "manual". | String | The name of the Manual Activity Sheet Name in the Activity Manager, |
sourceProjectId | Yes, if activitySheetType is "system". | String | Project added in integration tab in either from Gateway Sync or Primavera Cloud. |
projectType | No | String | The type of activity sheet. Valid values include:
Default is "Current". |
Response Format
A JSON object is returned in the following format:
{
"data": [],
"message": [<list of messages>],
"status": <REST status code value>,
"rest_audit_id": <id from the audit table>
}
A successful response displays a status code 200.
A failed response displays a message with a status code.
Sample Success Request
To recost a project, send a request in the following format:
{
"options": {
"project_number": "P-0056"
},
"data" :[{
"activitySheetName" : "ManualSheet01" ,
"activitySheetType" : "Manual"
}]
}
Sample Success Response
A successful response with status code 200 displays in the following format:
{
"data": [],
"message": [
{
"activitySheetName": "ManualSheet01",
"message" : "Recost job created Successfully.",
"jobId" : 1688113665288
}
],
"status": 202,
"rest_audit_id": 12676
}
Sample Request For System Sheet
Send a equest for a system sheet as shown below:
{
"options": {
"project_number": "P-0115"
},
"data" :[{
"activitySheetType" : "system",
"projectType":"Current",
"sourceProjectId":"ActivitySystem"
}]
}}
Sample Response
A response to the above request displays the corresponding status code in the following format:
{
"data": [],
"message": [
{
"jobId": 1717136939962,
"sourceProjectId": "ActivitySystem",
"message": "Recost job created Successfully."
}
],
"status": 202,
"rest_audit_id": 29877
}
Supported Validation Messages and Status Codes
The following validation messages and status codes display in the response when incorrect values are provided in the request.
Field Name | Use-case Scenario | Status Code | Error Message |
|---|---|---|---|
project_number | project_number is not specified. | 12018 | The API request is missing the required information: [project_number]. |
project_number | project_number is invalid. | 602 | Project/Shell Number is not correct. |
project_number | project_number is inactive. | 12020 | The API request contains an invalid value: [project_number]. Check the status of this project_number in Unifier. |
project_number | project_number is empty/blank. | 12128 | The API request contains empty value for: [project_number]. |
activitySheetType | activitySheetType value is not specified in the request. | 12010 | The API request is missing the required information: [activitySheetType] |
activitySheetType | activitySheetType is empty/blank. | 12034 | The API request contains an empty value for: [activitySheetType]. Allowed values: [manual, system] |
activitySheetType | activitySheetType is of incorrect data type. | 12704 | Invalid value was found in a field: [activitySheetType]. Allowed only alphanumeric value. |
activitySheetType | Accepting only "manual" or "system", else displaying validation message. | 12011 | Invalid value was found in a field: [activitySheetType]. Allowed values: [manual, system] |
activitySheetName | activitySheetName is not specified in the request. | 12012 | The API request is missing the required information: [activitySheetName]. |
activitySheetName | activitySheetName does not exist. | 12013 | The API request contains an invalid value: [activitySheetName]. Please check if this activitySheetName with sheet type=manual has been configured in Unifier. |
activitySheetName | activitySheetName value is null or empty. | 12068 | The API request contains empty value for: [activitySheetName]. |
sourceProjectId | sourceProjectId is not configured in the source Unifier shell. | 12021 | The API request contains an invalid value: [sourceProjectId]. Please check if this sourceProjectId has been configured in Unifier. |
sourceProjectId | sourceProjectId is not specified in the request. | 12005 | The API request is missing the required information: [sourceProjectId] |
sourceProjectId | sourceProjectId value is a blank. | 12032 | The API request contains empty value for: [sourceProjectId]. |
projectType | projectType is empty/blank for system sheet. | 12144 | The API request contains empty value for: [projectType]. Allowed values: [Current, Baseline] |
projectType | projectType is empty/blank for manual sheet. | 12144 | The API request contains empty value for: [projectType]. Allowed values: [Current, Baseline] |
projectType | projectType is of incorrect data type. | 12142 | Invalid value was found in a field: [projectType]. Allowed only alphanumeric value. |
projectType | An invalid value is passed in projectType for system sheet. | 12145 | Invalid value was found in a field: 'projectType'. Allowed values: [Current, Baseline] |
projectType | An invalid value is passed in projectType for manual sheet. | 12145 | Invalid value was found in a field: 'projectType'. Allowed values: [Current, Baseline] |
projectType | When "baseline" is passed, it is not configured for system sheet. | 12036 | Invalid value was found in a field: [projectType]. Baseline not defined for this Project. |
Related Topics
Create, Update, and Remove Assignments
Create or Update Assignment Spreads
Create or Update Activity Spreads
Create or Update Baseline Schedule for Manual Activity Sheet
Get Activities in the Manual Activity Sheet of a Specific Shell
Schedule Project for Manual Activity Sheet
Last Published Tuesday, April 15, 2025