Sign in

v3

latestSwagger 2.02026-08-067506752.0 MB
guideline

Create a new guideline

post/v1/org/{orgId}/guideline

Path parameters

orgIdstring required

Request body

compReviewIdstring required

comp review id

labelstring required

guideline name

budgetPoolIdstring

the budget pool the guideline is allocated from

participantsExprstring

CQL filter to determine which employees the guideline applies to

appliedFieldstring required

the field the guideline applies to

sourceFieldstring required

the field the guideline is calculated from

calculationType'RANGE' | 'TARGET' required

how does the guideline calculate the target value? e.g. is there a range (min/max) or only a target

flagMode'DEVIATION_THRESHOLD' | 'NONE' required

how does the guideline indicate deviations from the target amount

flagDeviationThresholdnumber

the threshold (percent) against which deviations from the guideline are flagged

enablePopulateValueboolean required

whether or not the target values from the guidelines are pre-populated in the given columns

basisType'CUSTOM' | 'FIXED' | 'CUSTOM_FIXED' | 'PERCENTAGE' | 'CUSTOM_PERCENTAGE' required

how an individual guideline value itself is calculated, e.g. percentage of the appliedField, fixed amount, or custom CQL

basisExprstring

if basisType.CUSTOM, the custom CQL expression used to generate the guideline value

Example request

{
  "compReviewId": "588f7ee98f138b19220041a7",
  "label": "Merit Guideline",
  "budgetPoolId": "588f7ee98f138b19220041a7",
  "participantsExpr": "is:person and tenure>=12",
  "appliedField": "'base' or 'grantShares'",
  "sourceField": "'base' or 'grantShares'",
  "calculationType": "TARGET",
  "flagMode": "NONE",
  "basisType": "CUSTOM",
  "basisExpr": "tenure>12 ? (base * 0.04) : (base * 0.02)"
}

Response

Created