View a Project Risk by Project and Risk Code
get
/primeapi/restapi/projectRisk/project/{id}/riskCode/{riskCode}
This endpoint returns project risks that meet the following requirements:
- The object belongs to a project with an ID value that matches the value of the {projectId} path parameter.
- The object has a risk with a code value that matches the value of the {riskCode} path parameter.
Request
Path Parameters
-
id: integer(int64)
The system-generated identifier of a project.
-
riskCode: string
The user-specified identifier of a risk.
Response
Supported Media Types
- application/json
200 Response
successful operation
Root Schema : ApiEntityProjectRisk
Type:
Show Source
object
-
cause(optional):
object RichTextString
-
cbsSheetCodeId(optional):
integer(int64)
The cost breakdown structure code assigned to the risk.
-
codeValuesRisk(optional):
array codeValuesRisk
Unique Items Required:
true
The user-specified identifier of a risk.VALUES -
costCategoryId(optional):
integer(int64)
The category name used to organize and define the cost.
-
costImpactQuantified(optional):
boolean
When selected, the quantified cost distribution is used to determine the cost impact for each iteration.
-
description(optional):
object RichTextString
-
effect(optional):
object RichTextString
-
hasPostResponseData(optional):
boolean
-
identifiedById(optional):
integer(int64)
-
identifiedDate(optional):
string(date-time)
-
impacts(optional):
array impacts
Unique Items Required:
true
-
itemPrefix(optional):
string
The auto numbering prefix of a code.
-
itemSuffix(optional):
integer(int64)
The auto numbering suffix of a code.
-
link(optional):
string(url)
Read Only:
true
-
ownerId(optional):
integer(int64)
-
postScore(optional):
integer(int32)
The risk calculation based on the post-response values defined for probability, cost impact, schedule impact, and any additional user-defined impacts for the risk.
-
probabilityImpactQuantified(optional):
boolean
When selected, the quantified probability distribution is used to determine the probability that the risk occurs for each iteration.
-
project(optional):
object ApiEntityProject
-
projectId(optional):
integer(int64)
-
projectRiskConfiguredFields(optional):
object ApiEntityProjectRiskConfiguredFields
-
projectRiskFinancial(optional):
object ApiEntityProjectRiskFinancial
-
projectRiskId(optional):
integer(int64)
-
quantifiedPostResponseProbabilityThreshold(optional):
number(double)
The probability threshold that a risk will occur after implementing a response action.
-
quantifiedPostResponseScheduleThreshold(optional):
number(double)
The estimated impact size that the risk will have on the project schedule after implementing a response action.
-
quantifiedProbabilityThreshold(optional):
number(double)
The estimated probability that a risk will occur before implementing a response action.
-
quantifiedScheduleThreshold(optional):
number(double)
The estimated impact size that the risk will have on the project schedule before implementing a response action.
-
riskCategory(optional):
object ApiEntityRiskCategory
-
riskCategoryId(optional):
integer(int64)
The unique identifier for the risk type.
-
riskCode(optional):
string
The unique identifier for the risk.
-
riskName(optional):
string
The name of the risk.
-
riskQuantifiedCostImpact(optional):
object ApiEntityRiskQuantifiedCostImpact
-
riskQuantifiedOtherImpacts(optional):
array riskQuantifiedOtherImpacts
Unique Items Required:
true
The impact this risk will have on other data. -
riskStatus(optional):
string
Allowed Values:
[ "PROPOSED", "OPEN", "ACTIVE", "REJECTED", "MANAGED", "IMPACTED" ]
-
riskType(optional):
string
Allowed Values:
[ "THREAT", "OPPORTUNITY" ]
The type of risk. Valid values are Threat and Opportunity. -
scheduleImpactQuantified(optional):
boolean
When selected, the quantified schedule impact distribution is used to calculate the schedule impact size for each iteration.
-
score(optional):
integer(int32)
The risk calculation based on the pre-response values defined for probability, cost impact, schedule impact, and any additional user-defined impacts for the risk.
-
updateDate(optional):
string(date-time)
Read Only:
true
Date when the record was last updated. Used for viewing and filtering records, obtained ONLY from GET calls, modified on and after a particular date. Not a part of POST response.
Nested Schema : codeValuesRisk
Type:
array
Unique Items Required:
true
The user-specified identifier of a risk.VALUES
Show Source
Nested Schema : ApiEntityProject
Type:
Show Source
object
-
actualDuration(optional):
object Duration
-
actualFinish(optional):
string(date-time)
The Actual Finish displays the date on which a project is considered complete.
This value can be entered manually or can be imported. -
actualLinkType(optional):
string
Allowed Values:
[ "BUDGET", "UDF", "MANUAL", "ACTUAL", "ACT_P6" ]
The field source for the actuals curve in cash flow. -
actualStart(optional):
string(date-time)
The Actual Start indicates the date work on the project began.
This value can be entered manually or can be imported. -
addressLine1(optional):
string
The first line of the address of a location.
This might be the building number and street address. -
addressLine2(optional):
string
The second line of the address of a location.
This might be a neighborhood or town. -
calendarId(optional):
integer(int64)
The unique identifier for the calendar.
-
cityName(optional):
string
The city name for a location.
-
codeValuesProject(optional):
array codeValuesProject
Unique Items Required:
true
The categories of a project. -
copyFromProjectId(optional):
integer(int64)
The system-generated identifier of the project this data was copied from.
-
countryCode(optional):
string
The country for a location.
-
currentApprovedFinishDate(optional):
string(date-time)
Read Only:
true
The finish date for the Current Approved Budget set by the budget planner. -
currentApprovedStartDate(optional):
string(date-time)
Read Only:
true
The start date for the Current Approved Budget set by the budget planner. -
dataDate(optional):
string(date-time)
The progress point, or "as-of date", for activities in the project. Project status is up-to-date as of the data date. You can set the data date when you schedule the project, or you can set it manually.
The data date is also used for updating the dates of scope assignments and work packages when they are not linked to activities. -
description(optional):
string
Allowed Values:
[ "Length[1-4000]" ]
The detailed summary for the project.
The description provides more information than short names or titles.
It can give background information or establish a purpose for the item.
These details help differentiate between items with similar names and are especially useful in multi-user environments. -
evaluationMatrixId(optional):
integer(int64)
The evaluation matrix of a calendar.
-
evaluationScore(optional):
object Percent
-
exchangeRateType(optional):
string
Allowed Values:
[ "FLOATING", "PEGGED" ]
The type of an exchange rate. -
finishDate(optional):
string(date-time)
The date on which all project work is complete.
This value can be entered manually or can be imported. -
finishDateVariance(optional):
object Duration
-
forecastFinishDate(optional):
string(date-time)
The planned finish date of a project's remaining Forecast cost.
-
forecastLinkType(optional):
string
Allowed Values:
[ "BUDGET", "UDF", "MANUAL", "ACTUAL", "ACT_P6" ]
The field source for the forecast curve in cash flow. -
forecastStartDate(optional):
string(date-time)
The planned start date of a project's remaining Forecast cost.
-
image(optional):
object ApiEntityProjectImage
-
isPSyncManaged(optional):
boolean
Read Only:
true
Indicates the project is synchronized with P6 EPPM. -
isTemplateFlag(optional):
boolean
Indicates the project is a template for creating other projects.
-
lastProjectEvaluationDate(optional):
string(date-time)
The date on which the project was last evaluated.
-
latitude(optional):
number(double)
The geographical coordinate for the latitude of the location.
The default format for latitude is decimal degrees format, but the format you need to use will depend on your geolocation service. -
link(optional):
string(url)
Read Only:
true
-
linkActualTo(optional):
integer(int64)
Specifies data to which project actuals data is linked.
-
linkForecastTo(optional):
integer(int64)
Specifies data to which a project forecast is linked.
-
linkForecastToSpend(optional):
boolean
Enables you to link project Forecast data to project Actuals data.
When linked, any updates to the project's Actuals values will automatically be applied to the project's Forecast values. -
linkPlannedBudgetTo(optional):
integer(int64)
Read Only:
true
Specifies data to which a project planned budget is linked. -
locationName(optional):
string
A name for the location that your users will understand and recognize.
-
longitude(optional):
number(double)
The geographical coordinate for the longitude of the location.
The default format for longitude is decimal degrees format, but the format you need to use will depend on your geolocation service. -
manager(optional):
string
The manager or person responsible for the project.
-
mustFinishByDate(optional):
string(date-time)
The latest date on which the scheduled activities must be complete for a project.
-
parentProject(optional):
integer(int64)
Read Only:
true
The workspace the project is associated with. -
pegRate(optional):
number
The custom exchange rate for a pegged exchange rate.
-
percentComplete(optional):
object Percent
-
percentCompleteWeightedBy(optional):
string
Read Only:
true
Allowed Values:[ "COST", "QUANTITY", "HOURS", "MANUAL" ]
The weight for scope items is calculated using quantity. -
planDuration(optional):
object Duration
-
planEndDate(optional):
string(date-time)
The finish date for the time phased Planned Budget of the project.
Planned Budget cost spread will adjust when this date is changed. -
plannedBudgetLinkType(optional):
string
Allowed Values:
[ "BUDGET", "UDF", "MANUAL", "ACTUAL", "ACT_P6" ]
The field source for the planned budget curve in cash flow. -
planStartDate(optional):
string(date-time)
The start date for the time phased Planned Budget of the project.
Planned Budget cost spread will adjust when this date is changed.
The Project Planned Start also represents the earliest date that activities can occur within a project schedule. -
postalCode(optional):
string
The postal code, post code, or zip code of a location.
-
priorityNum(optional):
integer(int64)
The project's priority in the strategic plan.
This priority value ranges from 1 to 10,000 with a default of 500. Use of the priority value, such as whether to place higher priority at the lower end of the scale, toward the endpoint 1, or at the higher end, toward 10,000, is at the discretion of the user. This field is not used for calculating data. -
projectAutoNumber(optional):
array projectAutoNumber
Read Only:
true
Unique Items Required:true
The autonumber settings of a project. -
projectCashFlows(optional):
array projectCashFlows
The cash flow of a project.
-
projectCode:
string
Allowed Values:
[ "Length[1-60]" ]
The unique identifier for a project set by the user who created the project. -
projectConfiguredFields(optional):
object ApiEntityProjectConfiguredFields
-
projectCurrency(optional):
integer(int64)
The unique identifier of a currency.
-
projectFinancial(optional):
object ApiEntityProjectFinancial
-
projectId(optional):
integer(int64)
The unique identifier for the project. This value should not be provided in create operation request data, however, it is required for update requests.
-
projectIntegrationType(optional):
string
Allowed Values:
[ "P6", "UNIFIER" ]
Specifies if the project is integrated with another application. -
projectName:
string
Allowed Values:
[ "Length[1-255]" ]
The name of the project. -
projectSettings(optional):
array projectSettings
Read Only:
true
Unique Items Required:true
-
proposedFinishDate(optional):
string(date-time)
Read Only:
true
The finish date for the Proposed Budget of the project. -
proposedStartDate(optional):
string(date-time)
Read Only:
true
The start date for the Proposed Budget of the project. -
recordCount(optional):
integer(int32)
The number of comments on a project.
-
remainingDuration(optional):
object Duration
-
reportCycleId(optional):
integer(int64)
The reporting cycle assigned to the project.
-
reportCycleNamingBoundary(optional):
string
Read Only:
true
Allowed Values:[ "REPORTING_PERIOD", "YEARLY", "QUARTERLY", "MONTHLY", "SEMIMONTHLY", "WEEKLY", "DAILY" ]
Determines when period names will be reset. The options available are based on the selection for Reporting Cycle. The standard calendar start and end dates are used as boundaries for resetting periods. -
riskLevel(optional):
string
Allowed Values:
[ "VERY_HIGH", "HIGH", "MEDIUM", "LOW", "VERY_LOW", "NULL" ]
The risk level assigned to the project.
Projects can have a risk level of very high, high, medium, low, or very low.
You can use risk level to determine what projects should be included in your plans, as well as which projects should be of priority. -
riskMatrixId(optional):
integer(int64)
The risk matrix assigned to the project for calculating project risk scores.
-
riskScore(optional):
integer(int32)
The risk score value is based on the probability and impacts of a risk. It is derived from the probability impact matrix and any associated rules.
-
scheduledFinishDate(optional):
string(date-time)
The calculated latest early finish date, which is based on the schedule most recently generated for the project.
-
securityGuid(optional):
string
Read Only:
true
Globally unique identifier of a project. -
sequenceNumber(optional):
integer(int32)
Determines the order of appearance of projects in a list.
-
sourceId(optional):
string
The unique identifier of a project in an external source.
-
spendEffectiveDate(optional):
string(date-time)
Read Only:
true
The month in which an actuals value was last added to the project. -
spendFinishDate(optional):
string(date-time)
Read Only:
true
The finish date for the project actuals. -
spendStartDate(optional):
string(date-time)
Read Only:
true
The start date for the project actuals. -
startDate(optional):
string(date-time)
The date on which work on the project starts.
This value can be entered manually or can be imported. -
startDateVariance(optional):
object Duration
-
stateCode(optional):
string
A unique identifier for the state or province.
-
stateName(optional):
string
The state, region, or province of a location.
-
status(optional):
string
Allowed Values:
[ "PROPOSAL", "REJECTED", "PLANNED", "ACTIVE", "INACTIVE", "COMPLETE" ]
The current status of a project.
Proposal: The project is a project proposal and has not been extensively planned nor accrued any costs.
Rejected: The project proposal has been rejected and will not be initiated as a project.
Planned: The project is currently planned for execution. Project managers input expected project costs and other project data during this stage.
Active: The project is currently active and being executed.
Inactive: The project has been rendered inactive and will temporarily accrue no costs.
Complete: The project has been successfully completed and will no longer accrue costs. -
strgyPriorityNum(optional):
integer(int64)
The project's priority in the strategic plan.
This priority value ranges from 1 to 10,000 with a default of 500. Use of the priority value, such as whether to place higher priority at the lower end of the scale, toward the endpoint 1, or at the higher end, toward 10,000, is at the discretion of the user. This field is not used for calculating data. -
summarizedDataDate(optional):
string(date-time)
The data date of a project.
-
updateDate(optional):
string(date-time)
Read Only:
true
Date when the record was last updated. Used for viewing and filtering records, obtained ONLY from GET calls, modified on and after a particular date. Not a part of POST response. -
websiteUrl(optional):
string
Allowed Values:
[ "Length[1-200]" ]
The link to a website related to the project. -
workspaceId:
integer(int64)
The workspace the project is associated with.
Nested Schema : ApiEntityProjectRiskConfiguredFields
Type:
Show Source
object
-
costFlexMap(optional):
object costFlexMap
Additional Properties Allowed: additionalPropertiesThe cost fields of a project risk.
-
link(optional):
string(url)
Read Only:
true
-
otherFlexMap(optional):
object otherFlexMap
Additional Properties Allowed: additionalPropertiesThe other configured fields of a project risk.
-
primaryKey(optional):
integer(int64)
-
projectRisk(optional):
object ApiEntityProjectRisk
-
projectRiskId(optional):
integer(int64)
Project ID.
-
textFlexMap(optional):
object textFlexMap
Additional Properties Allowed: additionalPropertiesThe text fields associated with a project risk.
-
uniqueName(optional):
string
-
updateDate(optional):
string(date-time)
Read Only:
true
Date when the record was last updated. Used for viewing and filtering records, obtained ONLY from GET calls, modified on and after a particular date. Not a part of POST response.
Nested Schema : ApiEntityProjectRiskFinancial
Type:
Show Source
object
-
actualResponseCost(optional):
object Cost
-
actualResponseCostProject(optional):
object Cost
-
link(optional):
string(url)
Read Only:
true
-
plannedResponseCost(optional):
object Cost
-
plannedResponseCostProject(optional):
object Cost
-
postExposureCost(optional):
object Cost
-
postExposureCostProject(optional):
object Cost
-
postQuantifiedCostThreshold(optional):
object Cost
-
postResponseExposureWorkspace1(optional):
object Cost
-
postResponseExposureWorkspace2(optional):
object Cost
-
postResponseExposureWorkspace3(optional):
object Cost
-
preExposureCost(optional):
object Cost
-
preExposureCostProject(optional):
object Cost
-
preQuantifiedCostThreshold(optional):
object Cost
-
preResponseExposureWorkspace1(optional):
object Cost
-
preResponseExposureWorkspace2(optional):
object Cost
-
preResponseExposureWorkspace3(optional):
object Cost
-
projectRiskId(optional):
integer(int64)
The unique identifier of a project.
-
updateDate(optional):
string(date-time)
Read Only:
true
Date when the record was last updated. Used for viewing and filtering records, obtained ONLY from GET calls, modified on and after a particular date. Not a part of POST response.
Nested Schema : ApiEntityRiskCategory
Type:
Show Source
object
-
link(optional):
string(url)
Read Only:
true
-
parentRiskCategory(optional):
object ApiEntityRiskCategory
-
parentRiskCategoryId(optional):
integer(int64)
The unique identifier of the parent of a risk type.
-
riskCategoryId(optional):
integer(int64)
The unique identifier of a risk type.
-
riskCategoryName(optional):
string
The category to which the risk belongs.
-
updateDate(optional):
string(date-time)
Read Only:
true
Date when the record was last updated. Used for viewing and filtering records, obtained ONLY from GET calls, modified on and after a particular date. Not a part of POST response. -
workspace(optional):
object ApiEntityWorkspace
-
workspaceId(optional):
integer(int64)
The unique identifier of a workspace.
Nested Schema : ApiEntityRiskQuantifiedCostImpact
Type:
Show Source
object
-
link(optional):
string(url)
Read Only:
true
-
postResponseDistributionShape(optional):
string
Allowed Values:
[ "NONE", "TRIANGLE", "UNIFORM", "GAUSSIAN", "SINGLE_POINT" ]
Determines the distribution that best models the three-point estimates for activity durations after a response. -
postResponseMaximum(optional):
object Cost
-
postResponseMaximumProject(optional):
object Cost
-
postResponseMaximumWorkspace1(optional):
object Cost
-
postResponseMaximumWorkspace2(optional):
object Cost
-
postResponseMaximumWorkspace3(optional):
object Cost
-
postResponseMinimum(optional):
object Cost
-
postResponseMinimumProject(optional):
object Cost
-
postResponseMinimumWorkspace1(optional):
object Cost
-
postResponseMinimumWorkspace2(optional):
object Cost
-
postResponseMinimumWorkspace3(optional):
object Cost
-
postResponseMostLikely(optional):
object Cost
-
postResponseMostLikelyProject(optional):
object Cost
-
postResponseMostLikelyWorkspace1(optional):
object Cost
-
postResponseMostLikelyWorkspace2(optional):
object Cost
-
postResponseMostLikelyWorkspace3(optional):
object Cost
-
preResponseDistributionShape(optional):
string
Allowed Values:
[ "NONE", "TRIANGLE", "UNIFORM", "GAUSSIAN", "SINGLE_POINT" ]
Determines the distribution that best models the three-point estimates for activity durations before a response. -
preResponseMaximum(optional):
object Cost
-
preResponseMaximumProject(optional):
object Cost
-
preResponseMaximumWorkspace1(optional):
object Cost
-
preResponseMaximumWorkspace2(optional):
object Cost
-
preResponseMaximumWorkspace3(optional):
object Cost
-
preResponseMinimum(optional):
object Cost
-
preResponseMinimumProject(optional):
object Cost
-
preResponseMinimumWorkspace1(optional):
object Cost
-
preResponseMinimumWorkspace2(optional):
object Cost
-
preResponseMinimumWorkspace3(optional):
object Cost
-
preResponseMostLikely(optional):
object Cost
-
preResponseMostLikelyProject(optional):
object Cost
-
preResponseMostLikelyWorkspace1(optional):
object Cost
-
preResponseMostLikelyWorkspace2(optional):
object Cost
-
preResponseMostLikelyWorkspace3(optional):
object Cost
-
projectRiskId(optional):
integer(int64)
The unique identifier of a project.
-
quantifiedCostImpactId(optional):
integer(int64)
The unique identifier of a cost impact.
-
updateDate(optional):
string(date-time)
Read Only:
true
Date when the record was last updated. Used for viewing and filtering records, obtained ONLY from GET calls, modified on and after a particular date. Not a part of POST response.
Nested Schema : riskQuantifiedOtherImpacts
Type:
array
Unique Items Required:
true
The impact this risk will have on other data.
Show Source
Nested Schema : ApiEntityCodeValueRisk
Type:
Show Source
object
-
codeType(optional):
object ApiEntityCodeType
-
codeValue(optional):
object ApiEntityCodeValue
-
codeValueRiskId(optional):
integer(int64)
The unique identifier of a risk code value.
-
link(optional):
string(url)
Read Only:
true
-
projectRiskId(optional):
integer(int64)
The unique identifier of a project.
-
updateDate(optional):
string(date-time)
Read Only:
true
Date when the record was last updated. Used for viewing and filtering records, obtained ONLY from GET calls, modified on and after a particular date. Not a part of POST response.
Nested Schema : ApiEntityCodeType
Type:
Show Source
object
-
assignments(optional):
array assignments
Unique Items Required:
true
CodeType assignments. -
codeTypeCode:
string
Allowed Values:
[ "Length[1-40]" ]
This field displays the name of a code or value. -
codeTypeId(optional):
integer(int64)
The system-generated identifier of a code type.
-
codeTypeName:
string
Allowed Values:
[ "Length[1-40]" ]
The name of a code or value. -
link(optional):
string(url)
Read Only:
true
-
pushDownType:
string
Allowed Values:
[ "MANUAL", "AUTOMATIC" ]
The push down type of the workspace code. -
updateDate(optional):
string(date-time)
Read Only:
true
Date when the record was last updated. Used for viewing and filtering records, obtained ONLY from GET calls, modified on and after a particular date. Not a part of POST response. -
workspace:
integer(int64)
The ID of the owning workspace.
Nested Schema : ApiEntityCodeValue
Type:
Show Source
object
-
codeTypeId:
integer(int64)
The ID for the code type.
-
codeTypeName:
string
The name of a code or value.
-
codeValueCode:
string
Allowed Values:
[ "LENGTH[1-32]" ]
The unique identifier for the code value. -
codeValueId(optional):
integer(int64)
The unique identifier for the code value.
-
codeValueName:
string
Allowed Values:
[ "LENGTH[1-100]" ]
The name of the code value. -
link(optional):
string(url)
Read Only:
true
-
parentCodeValue(optional):
integer(int64)
The parent code value.
-
sequenceNumber:
integer(int32)
The number that specifies the position of the code value item within the code type list.
-
updateDate(optional):
string(date-time)
Read Only:
true
Date when the record was last updated. Used for viewing and filtering records, obtained ONLY from GET calls, modified on and after a particular date. Not a part of POST response.
Nested Schema : assignments
Type:
array
Unique Items Required:
true
CodeType assignments.
Show Source
Nested Schema : ApiEntityCodeEntityType
Type:
Show Source
object
-
codeType:
object ApiEntityCodeType
-
entityType:
string
Allowed Values:
[ "SCOPE_ITEM", "PROJECT", "SCOPE_ASSIGNMENT", "WBS", "WORK_PACKAGE", "ACTIVITY", "RESOURCE", "PBS", "CONTRACT", "RISK", "COMMITMENT", "REPORT", "TASKS", "STRATEGY", "PORTFOLIO", "FUND", "SUBMITTAL", "CHANGE_ORDER", "PAYMENT_APPLICATION", "CHANGE_EVENT", "CHANGES_ESTIMATES", "IDEA", "RFI", "CUSTOM_LOG_ITEM" ]
Indicates the type of object the code is associated to. -
link(optional):
string(url)
Read Only:
true
-
primaryKey:
integer(int64)
The unique identifier of a code type table.
-
updateDate(optional):
string(date-time)
Read Only:
true
Date when the record was last updated. Used for viewing and filtering records, obtained ONLY from GET calls, modified on and after a particular date. Not a part of POST response.
Nested Schema : ApiEntityRiskImpact
Type:
Show Source
object
-
link(optional):
string(url)
Read Only:
true
-
postRiskScoreThresholdCode(optional):
string
-
postRiskScoreThresholdId(optional):
integer(int64)
The unique identifier for the post response impact threshold.
-
projectName(optional):
string
-
projectRisk(optional):
object ApiEntityProjectRisk
-
projectRiskId(optional):
integer(int64)
The unique identifier of the project to which the risk is assigned.
-
riskCode(optional):
string
-
riskImpactId(optional):
integer(int64)
A database generated unique value for the object that links the RSK_PROJECT to the selected threshold. It also includes the scoretype.
-
riskScoreThreshold(optional):
object ApiEntityRiskScoreThreshold
-
riskScoreThresholdCode(optional):
string
-
riskScoreThresholdId(optional):
integer(int64)
The threshold of the risk score.
-
riskScoreType(optional):
object ApiEntityRiskScoreType
-
riskScoreTypeId(optional):
integer(int64)
The risk score type.
-
riskScoreTypeName(optional):
string
-
updateDate(optional):
string(date-time)
Read Only:
true
Date when the record was last updated. Used for viewing and filtering records, obtained ONLY from GET calls, modified on and after a particular date. Not a part of POST response.
Nested Schema : ApiEntityRiskScoreThreshold
Type:
Show Source
object
-
color(optional):
string
The color that represents the urgency of the risk.
-
level(optional):
integer(int32)
The level of the risk threshold.
-
link(optional):
string(url)
Read Only:
true
-
lower(optional):
number(double)
The lower limit of the risk score threshold range.
-
riskScoreThresholdCode(optional):
string
The unique identifier for the risk scoring threshold.
-
riskScoreThresholdId(optional):
integer(int64)
The unique ID of the risk score threshold.
-
riskScoreThresholdName(optional):
string
The name of the risk threshold.
-
riskScoreType(optional):
object ApiEntityRiskScoreType
-
riskScoreTypeId(optional):
integer(int64)
The category to which the risk score belongs.
-
riskScoreTypeName(optional):
string
The name of the risk score type.
-
stringValue(optional):
string
The value of the string.
-
updateDate(optional):
string(date-time)
Read Only:
true
Date when the record was last updated. Used for viewing and filtering records, obtained ONLY from GET calls, modified on and after a particular date. Not a part of POST response. -
upper(optional):
number(double)
The upper limit of the risk score threshold range.
Nested Schema : ApiEntityRiskScoreType
Type:
Show Source
object
-
link(optional):
string(url)
Read Only:
true
-
projectId(optional):
integer(int64)
The unique identifier of a project.
-
pushDownType(optional):
string
Allowed Values:
[ "MANUAL", "AUTOMATIC" ]
The push down type of the risk score. -
referencedScoreTypeId(optional):
integer(int64)
The unique identifier of a copied score type.
-
riskScoreThresholds(optional):
array riskScoreThresholds
Unique Items Required:
true
Risk score thresholds. -
riskScoreTypeId(optional):
integer(int64)
The unique identifier of a score type.
-
riskScoreTypeName(optional):
string
The name of the risk score type.
-
scoreType(optional):
string
Allowed Values:
[ "PROBABILITY", "SCHEDULE", "RELATIVE_SCHEDULE", "COST", "RELATIVE_COST", "USER" ]
The type of risk score. -
updateDate(optional):
string(date-time)
Read Only:
true
Date when the record was last updated. Used for viewing and filtering records, obtained ONLY from GET calls, modified on and after a particular date. Not a part of POST response. -
workspace(optional):
object ApiEntityWorkspace
-
workspaceId(optional):
integer(int64)
The unique identifier of a workspace.
Nested Schema : riskScoreThresholds
Type:
array
Unique Items Required:
true
Risk score thresholds.
Show Source
Nested Schema : ApiEntityWorkspace
Type:
Show Source
object
-
description(optional):
string
Summary of the workspace.
-
image(optional):
object ApiEntityWorkspaceImage
-
isProduction(optional):
boolean
Read Only:
true
Indicates a workspace that is in production.
All workspaces created under the Production workspace are automatically designated as production.
This cannot be changed. -
isSysGenerated(optional):
boolean
Read Only:
true
Indicates a workspace that was created by the system.
System generated workspaces cannot be deleted. -
link(optional):
string(url)
Read Only:
true
-
parentWorkspace(optional):
integer(int64)
The unique identifier of the workspace hierarchically above another workspace.
-
securityGuid(optional):
string
The Globally Unique Identifier of the workspace.
-
sequenceNumber(optional):
integer(int32)
Determines the order of appearance of workspaces in a list.
-
updateDate(optional):
string(date-time)
Read Only:
true
Date when the record was last updated. Used for viewing and filtering records, obtained ONLY from GET calls, modified on and after a particular date. Not a part of POST response. -
workspaceAutonumSettings(optional):
array workspaceAutonumSettings
Unique Items Required:
true
An object containing workspace autonumber settings. -
workspaceCode(optional):
string
Workspace Code.
-
workspaceId(optional):
integer(int64)
The unique identifier of a workspace.
-
workspaceName(optional):
string
Name of a workspace.
-
workspaceSettings(optional):
array workspaceSettings
Unique Items Required:
true
An object containing workspace settings.
Nested Schema : ApiEntityWorkspaceImage
Type:
Show Source
object
-
image(optional):
array image
An image object represented in binary format.
-
imageType:
string
Allowed Values:
[ "PNG", "JPEG", "GIF" ]
The file type of the image. Valid values are PNG, JPEG, and GIF. -
link(optional):
string(url)
Read Only:
true
-
updateDate(optional):
string(date-time)
Read Only:
true
Date when the record was last updated. Used for viewing and filtering records, obtained ONLY from GET calls, modified on and after a particular date. Not a part of POST response. -
workspaceId:
integer(int64)
The unique identifier of the workspace that contains this image.
-
workspaceImageId:
integer(int64)
The unique identifier of the image.
Nested Schema : workspaceAutonumSettings
Type:
array
Unique Items Required:
true
An object containing workspace autonumber settings.
Show Source
Nested Schema : workspaceSettings
Type:
array
Unique Items Required:
true
An object containing workspace settings.
Show Source
Nested Schema : ApiEntityWorkspaceAutonumSetting
Type:
Show Source
object
-
area(optional):
string
Allowed Values:
[ "IDEA", "ACTIVITY", "ACTIVITY_ASSIGNMENT", "SCOPE_ITEM", "SCOPE_ASSIGNMENT", "CHANGE_ITEM", "WORK_PACKAGE", "CHANGE_REQUEST", "CONTRACT", "COMMITMENT", "BUDGET_CHANGE", "BUDGET_TRANSFER", "CHANGE_ORDER", "POTENTIAL_CHANGE_ORDER", "PAYMENT_APPLICATION", "RISK", "ACTUALS", "WORK_MANAGER_TASK", "SUBMITTAL", "CHANGE_EVENT", "RFI", "CUSTOM_LOGS_ITEM" ]
Identifies the type of object used for auto numbering. -
autonumId(optional):
integer(int64)
The unique identifier of an auto numbering sequence.
-
link(optional):
string(url)
Read Only:
true
-
name(optional):
string
Name of the auto numbering sequence.
-
prefix(optional):
string
Initial characters for the workspace auto numbering sequence.
-
suffix(optional):
string
The first number in the workspace auto numbering sequence.
-
suffixIncrement(optional):
integer(int32)
Number by which the auto numbering suffix is incremented.
-
updateDate(optional):
string(date-time)
Read Only:
true
Date when the record was last updated. Used for viewing and filtering records, obtained ONLY from GET calls, modified on and after a particular date. Not a part of POST response. -
workspaceId(optional):
integer(int64)
The unique identifier of a workspace.
Nested Schema : ApiEntityWorkspaceSetting
Type:
Show Source
object
-
link(optional):
string(url)
Read Only:
true
-
settingName:
string
Name of a workspace setting.
-
settingValue:
string
Value of a workspace setting.
-
updateDate(optional):
string(date-time)
Read Only:
true
Date when the record was last updated. Used for viewing and filtering records, obtained ONLY from GET calls, modified on and after a particular date. Not a part of POST response. -
workspaceId:
integer(int64)
The unique identifier of a workspace setting.
-
workspaceSettingId:
integer(int64)
The unique identifier of a workspace setting.
Nested Schema : codeValuesProject
Type:
array
Unique Items Required:
true
The categories of a project.
Show Source
Nested Schema : ApiEntityProjectImage
Type:
Show Source
object
-
image:
array image
The image file uploaded to the project.
Displayed throughout the application in areas like news feeds. -
imageType:
string
Allowed Values:
[ "PNG", "JPEG", "GIF" ]
The mime type of an image associated with a project. -
link(optional):
string(url)
Read Only:
true
-
project(optional):
integer(int64)
The system-generated identifier of a project.
-
projectImageId(optional):
integer(int64)
The system-generated identifier of a project image. This value should not be provided in create operation request data, however, it is required for update requests.
-
updateDate(optional):
string(date-time)
Read Only:
true
Date when the record was last updated. Used for viewing and filtering records, obtained ONLY from GET calls, modified on and after a particular date. Not a part of POST response.
Nested Schema : projectAutoNumber
Type:
array
Read Only:
true
Unique Items Required:
true
The autonumber settings of a project.
Show Source
Nested Schema : ApiEntityProjectConfiguredFields
Type:
Show Source
object
-
costFlexMap(optional):
object costFlexMap
Additional Properties Allowed: additionalPropertiesThe cost fields associated with a project.
-
link(optional):
string(url)
Read Only:
true
-
otherFlexMap(optional):
object otherFlexMap
Additional Properties Allowed: additionalPropertiesThe non-cost and non-text fields associated with a project.
-
project(optional):
object ApiEntityProject
-
projectId(optional):
integer(int64)
The unique identifier for the project.
-
textFlexMap(optional):
object textFlexMap
Additional Properties Allowed: additionalPropertiesThe text fields associated with a project.
-
updateDate(optional):
string(date-time)
Read Only:
true
Date when the record was last updated. Used for viewing and filtering records, obtained ONLY from GET calls, modified on and after a particular date. Not a part of POST response.
Nested Schema : ApiEntityProjectFinancial
Type:
Show Source
object
-
actualCost(optional):
object Cost
-
allocatedFundApprovedBudgetVariance(optional):
object Cost
-
allocatedFundForecastVariance(optional):
object Cost
-
allocatedFundPlannedBudgetVariance(optional):
object Cost
-
annualDiscountRate(optional):
object Percent
-
atCompletionCost(optional):
object Cost
-
constructionValue(optional):
object Cost
-
costPerfIndex(optional):
number(double)
The measure of a project's cost efficiency.
A value of less than 1 indicates the project is over budget, while a value greater than 1 indicates the project is under budget.
This value can be entered manually or can be imported. -
costVariance(optional):
object Cost
-
currentApprovedBudget(optional):
object Cost
-
currentApprovedBudgetBaseDistributed(optional):
object Cost
-
currentApprovedBudgetBaseUndistributed(optional):
object Cost
-
currentApprovedSpendVariance(optional):
object Cost
-
earnedValueCost(optional):
object Cost
-
estAtCompleteCost(optional):
object Cost
-
estToCompleteCost(optional):
object Cost
-
forecastCost(optional):
object Cost
-
forecastCostDistributed(optional):
object Cost
-
forecastCostUndistributed(optional):
object Cost
-
forecastCurrApprVar(optional):
object Cost
-
intRateReturn(optional):
object Percent
-
link(optional):
string(url)
Read Only:
true
-
netPresentValue(optional):
object Cost
-
paybackPeriod(optional):
number(double)
The estimate of the length of time that will transpire before net profits recover the initial and periodic costs of an investment to carry out the selected project.
This value can be entered manually or can be imported. -
plannedBudget(optional):
object Cost
-
plannedBudgetDistributed(optional):
object Cost
-
plannedBudgetUndistributed(optional):
object Cost
-
plannedValueCost(optional):
object Cost
-
profitabilityIndex(optional):
number(double)
The index based on the value of a project's present values divided by initial project investments.
-
project:
object ApiEntityProject
-
projectId(optional):
integer(int64)
The unique identifier for a project set by the user who created the project.
-
proposedBudget(optional):
object Cost
-
proposedBudgetBaseDistributed(optional):
object Cost
-
proposedBudgetBaseUndistributed(optional):
object Cost
-
proposedForecastVariance(optional):
object Cost
-
proposedPlannedVar(optional):
object Cost
-
remainingCost(optional):
object Cost
-
returnInvestment(optional):
object Percent
-
schedPerfIndex(optional):
number(double)
The measure of the work accomplished as a percentage of the work scheduled on a project.
Schedule Performance Index indicates whether you are meeting earned and planned values within your project schedule.
A value less than 1 indicates that less work was performed than was scheduled. A value greater than 1 indicates the project is ahead of schedule.
This value can be entered manually or can be imported. -
scheduleVariance(optional):
object Cost
-
spendCost(optional):
object Cost
-
spendForecastVar(optional):
object Cost
-
spendPlannedVariance(optional):
object Cost
-
updateDate(optional):
string(date-time)
Read Only:
true
Date when the record was last updated. Used for viewing and filtering records, obtained ONLY from GET calls, modified on and after a particular date. Not a part of POST response. -
yearEndForecastCost(optional):
object Cost
-
ytdSpendCost(optional):
object Cost
Nested Schema : ApiEntityCodeValueProject
Type:
Show Source
object
-
codeType(optional):
object ApiEntityCodeType
-
codeValue:
object ApiEntityCodeValue
-
codeValueProjectId:
integer(int64)
The unique identifier of the workspace where the code value was created. This value should not be provided in create operation request data, however, it is required for update requests.
-
link(optional):
string(url)
Read Only:
true
-
projectId(optional):
integer(int64)
The unique identifier for the project.
-
updateDate(optional):
string(date-time)
Read Only:
true
Date when the record was last updated. Used for viewing and filtering records, obtained ONLY from GET calls, modified on and after a particular date. Not a part of POST response.
Nested Schema : image
Type:
array
The image file uploaded to the project.
Displayed throughout the application in areas like news feeds.
Show Source
Displayed throughout the application in areas like news feeds.
Nested Schema : ApiEntityProjectAutoNumber
Type:
Show Source
object
-
area(optional):
string
Allowed Values:
[ "IDEA", "ACTIVITY", "ACTIVITY_ASSIGNMENT", "SCOPE_ITEM", "SCOPE_ASSIGNMENT", "CHANGE_ITEM", "WORK_PACKAGE", "CHANGE_REQUEST", "CONTRACT", "COMMITMENT", "BUDGET_CHANGE", "BUDGET_TRANSFER", "CHANGE_ORDER", "POTENTIAL_CHANGE_ORDER", "PAYMENT_APPLICATION", "RISK", "ACTUALS", "WORK_MANAGER_TASK", "SUBMITTAL", "CHANGE_EVENT", "RFI", "CUSTOM_LOGS_ITEM" ]
Identifies the type of object used for auto numbering. -
increment:
integer(int32)
The number to increment the starting number by.
-
link(optional):
string(url)
Read Only:
true
-
name:
string
This is an internal field.
-
prefix:
string
Allowed Values:
[ "Length[1-20]" ]
The initial characters for the auto numbering sequence. -
projectAutoNumberId(optional):
integer(int64)
The auto generated ID for the object. This value should not be provided in create operation request data, however, it is required for update requests.
-
suffix:
string
The first number in the auto numbering sequence.
-
updateDate(optional):
string(date-time)
Read Only:
true
Date when the record was last updated. Used for viewing and filtering records, obtained ONLY from GET calls, modified on and after a particular date. Not a part of POST response.
Nested Schema : ApiEntityProjectCashFlow
Type:
Show Source
object
-
actualCost:
object Cost
-
actualForecastVar(optional):
object Cost
-
atCompletionCost(optional):
object Cost
-
currentApprovedBudget(optional):
object Cost
-
currentApprovedSpendVariance(optional):
object Cost
-
forecastCost:
object Cost
-
forecastCurrApprVar(optional):
object Cost
-
link(optional):
string(url)
Read Only:
true
-
month:
integer(int32)
The time period during which budget planning for the project takes place in months.
-
plannedBudget:
object Cost
-
projectId:
integer(int64)
The unique identifier for the project.
-
projectPhaseFinancialId(optional):
integer(int64)
The unique internal identifier for the project's time-phased cost spread. This value should not be provided in create operation request data, however, it is required for update requests.
-
proposedBudget(optional):
object Cost
-
proposedForecastVariance(optional):
object Cost
-
proposedPlannedVar(optional):
object Cost
-
spendCost(optional):
object Cost
-
spendForecastVar(optional):
object Cost
-
spendPlannedVariance(optional):
object Cost
-
spreadDate(optional):
string(date-time)
The starting date for a time phase of the project life cycle.
-
updateDate(optional):
string(date-time)
Read Only:
true
Date when the record was last updated. Used for viewing and filtering records, obtained ONLY from GET calls, modified on and after a particular date. Not a part of POST response. -
year:
integer(int32)
The time period during which budget planning for the project takes place in years.
-
yearEndBudger(optional):
object Cost
-
yearEndForecastCost(optional):
object Cost
-
ytdActualCost(optional):
object Cost
-
ytdSpendCost(optional):
object Cost
Nested Schema : Cost
Type:
object
Nested Schema : costFlexMap
Type:
object
Additional Properties Allowed
Show Source
The cost fields associated with a project.
Nested Schema : otherFlexMap
Type:
object
Additional Properties Allowed
Show Source
The non-cost and non-text fields associated with a project.
Nested Schema : textFlexMap
Type:
object
Additional Properties Allowed
Show Source
The text fields associated with a project.
Nested Schema : additionalProperties
Type:
object
Nested Schema : additionalProperties
Type:
object
Nested Schema : additionalProperties
Type:
object
Nested Schema : ApiEntityProjectSetting
Type:
Show Source
object
-
link(optional):
string(url)
Read Only:
true
-
projectId(optional):
integer(int64)
The unique identifier of a project.
-
projectSettingId(optional):
integer(int64)
The unique identifier of a project setting. This value should not be provided in create operation request data, however, it is required for update requests.
-
settingName(optional):
string
The name of a project button.
-
settingValue(optional):
string
Value of a project setting.
-
updateDate(optional):
string(date-time)
Read Only:
true
Date when the record was last updated. Used for viewing and filtering records, obtained ONLY from GET calls, modified on and after a particular date. Not a part of POST response.
Nested Schema : costFlexMap
Type:
object
Additional Properties Allowed
Show Source
The cost fields of a project risk.
Nested Schema : otherFlexMap
Type:
object
Additional Properties Allowed
Show Source
The other configured fields of a project risk.
Nested Schema : textFlexMap
Type:
object
Additional Properties Allowed
Show Source
The text fields associated with a project risk.
Nested Schema : additionalProperties
Type:
object
Nested Schema : additionalProperties
Type:
object
Nested Schema : additionalProperties
Type:
object
Nested Schema : ApiEntityRiskQuantifiedOtherImpact
Type:
Show Source
object
-
link(optional):
string(url)
Read Only:
true
-
maximum(optional):
number(double)
The maximum probability that a risk event will occur.
-
minimum(optional):
number(double)
The minimum probability that a risk event will occur.
-
mostLikely(optional):
number(double)
The most likely probability that a risk event will occur.
-
preOrPostResponse(optional):
string
Allowed Values:
[ "PRE_RESPONSE", "POST_RESPONSE" ]
Indicates whether a risk impact is measured pre or post response. -
projectRiskId(optional):
integer(int64)
The unique identifier of a project.
-
quantifiedOtherImpactId(optional):
integer(int64)
The unique identifier of a risk impact.
-
scoreType(optional):
string
Allowed Values:
[ "PROBABILITY", "SCHEDULE", "RELATIVE_SCHEDULE", "COST", "RELATIVE_COST", "USER" ]
The type of an impact score. -
shape(optional):
string
Allowed Values:
[ "NONE", "TRIANGLE", "UNIFORM", "GAUSSIAN", "SINGLE_POINT" ]
The distribution that best models the three-point estimates for risk probabilities. -
updateDate(optional):
string(date-time)
Read Only:
true
Date when the record was last updated. Used for viewing and filtering records, obtained ONLY from GET calls, modified on and after a particular date. Not a part of POST response.
404 Response
The requested risk does not exist or you do not have access to it.