Sign in

v3

latestSwagger 2.02026-08-067506752.0 MB
budget-pool

Create a new budget pool

post/v1/org/{orgId}/budget-pool

Path parameters

orgIdstring required

Org identifier (either id or slug

Request body

compReviewIdstring required

the ID of the comp review this budget is for

labelstring required

unique label

participantsExprstring

expression that determines if a particular job is included in this budget pool

appliedFieldstring required

the field this budget pool applies to

sourceFieldstring required

the field this budget pool is calculated from

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

the method for calculating the amount in the budget

fixedValuenumber

a fixed amount for the budget (used with basisType=FIXED || basisType=PERCENTAGE)

fixedBudgetMapobject

a map of reviewer job IDs to fixed budget money amounts

basisExprstring

expression that calculates how much each job contributes to the budget (used with basisType=CUSTOM)

defaultCurrencystring

Default currency used when calculating budget pool, falls back to org primary currency if not set

visibilityType'DEFAULT' | 'ROLE_SELECTION' | 'SPECIFIC_PEOPLE' | 'CUSTOM_CQL' required

Controls who can view this budget

visibilityExprstring

CQL expression evaluated on the user to determine visibility (used with visibilityType=CUSTOM_CQL)

visibilityPersonIdsstring[]

Set of person IDs who can view this budget (used with visibilityType=SPECIFIC_PEOPLE)

sortinteger

sort order for sequential budget allocation priority

Example request

{
  "compReviewId": "588f7ee98f138b19220041a7",
  "label": "Merit",
  "appliedField": "base",
  "sourceField": "base",
  "visibilityPersonIds": [
    "588f7ee98f138b19220041a7"
  ]
}