ProjectStage
An object representing a project stage.
Supported API Calls: List | Get | Add | Update | Delete
Object Properties
Property |
Type |
Description |
Id |
integer |
A unique ID representing the ProjectStage object. When adding a new ProjectStage the value must be 0. |
ProjectId |
integer |
The ID for the parent project object. |
Name |
string (100) |
The stage's name field. |
Description |
string (100) |
The stage's description text. |
StartDate |
DateTime |
Stage start date. Optional. This value can be null. |
ActualStartDate |
DateTime |
Stores the actual date the stage was started. This value is optional. |
EstimatedCompletionDate |
DateTime |
Date value for the Estimated Completion Date field. This value is optional. |
CompletionDate |
DateTime |
Stores the actual completing date. This value is optional. |
Status |
integer |
ID to set the stage's Status drop-down box. Value should be equal to a ProjectStageStatus object's ID field. |
IsCompleted |
boolean |
Flag to indicate the stage is completed. |
IsRequireSignoff |
boolean |
Flag to indicate the stage requires external user signoff. |
IsSignoff |
boolean |
Flag to indicate the stage was signed off. |
SignoffDate |
DateTime |
Date value indicating when the stage was signed off. This value is optional. |
SignoffIpAddress |
string (100) |
Stores the external user's IP address. |
SortOrder |
integer |
Sorting order of the stage. This can be null. Read only. |
OwnerId |
integer |
ID of the user who owns this object. This value is optional. |
IsInvoiceRequired |
boolean |
Flag to indicate a completed stage should generate an invoice. |
InvoiceAmountType |
string (100) |
Indicates what kind of invoice should be generated. Values are percentage, fixed. |
InvoiceAmount |
double |
Value of the invoice. This value is optional. |
InvoiceDueDate |
integer |
How many days after the stage is completed should the invoice be generated. This value is optional. |
IsInvoicePaid |
boolean |
Flag to indicate the project's invoice has been paid. |
TaskList |
List<Task> |
A list of task objects associated with this project stage. |
DependencyList |
List<ProjectMilestoneDependency> |
A list of dependencies for this stage. |
List
Description
Returns a list of project stages associated with the project.
URL
https://{company}.bluecamroo.com/api/ProjectMilestone/list?projectId={projectId}
HTTP Method
GET
Parameters
None.
Data Return
Returns the list of stages for the specified project in the requested format (e.g., JSON or XML)
HTTP Return Status Code
200: Ok
401: Not authorized (you need to log in)
Get
Description
Returns the details of a project stage.
URL
https://{company}.bluecamroo.com/api/ProjectMilestone/get/{id}
HTTP Method
GET
Parameters
None.
Data Return
Returns the ProjectStage object in the requested format (e.g., JSON or XML)
HTTP Return Status Code
200: Ok
400: Bad Request (One or more input data items is not valid, for example a mandatory field is blank)
401: Not authorized (you need to log in)
403: Forbidden (you don't have permission to this resource)
Add
Description
Adds a stage to a project.
URL
https://{company}.bluecamroo.com/api/ProjectMilestone/add
HTTP Method
POST
Parameters
A ProjectStage object
Data Return
Returns the ProjectStage object in the requested format (e.g., JSON or XML)
HTTP Return Status Code
201: Created
401: Not authorized (you need to log in)
403: Forbidden (you don't have permission to this resource)
Update
Description
Updates a ProjectStage object to replace the specified project stage.
URL
https://{company}.bluecamroo.com/api/ProjectMilestone/update
HTTP Method
PUT
Parameters
A ProjectStage object
Data Return
Returns the ProjectStage object in the requested format (e.g., JSON or XML)
HTTP Return Status Code
200: Ok
400: Bad Request (One or more input data items is not valid, for example a mandatory field is blank)
401: Not authorized (you need to log in)
403: Forbidden (you don't have permission to this resource)
Delete
Description
Deletes the project stage.
URL
https://{company}.bluecamroo.com/api/ProjectMilestone/delete/{id}
HTTP Method
DELETE
Parameters
None
Data Return
None
HTTP Return Status Code
200: Ok
400: Bad Request (One or more input data items is not valid, for example a mandatory field is blank)
401: Not authorized (you need to log in)
403: Forbidden (you don't have permission to this resource)