Compensation Planning
Public API

Update compensation planning cycle

Changed on

Update compensation planning cycle details and currency settings.

OAuth Scopes: planning_cycles.write

put/api/v1/compensation/planning_cycles/{id}

Request

Path parameters

idinteger required

Request body

idstring

ID of the cycle to update

cycleNamestring nullable

Name of the cycle to update

cycleCurrencystring nullable

Currency code for the cycle

cycleWindowStartYmdstring date

Start date of the cycle window

cycleWindowEndYmdstring date

End date of the cycle window

recommendationsDueYmdstring date

Date when recommendations are due

approvalsDueYmdstring date

Date when approvals are due

cycleEffectiveDatestring date

Effective date of the cycle

salaryIncludedboolean nullable

Whether salary is included in this cycle. Omit to leave the saved value unchanged.

bonusIncludedboolean nullable

Whether bonus is included in this cycle. Omit to leave the saved value unchanged.

equityIncludedboolean nullable

Whether equity is included in this cycle. Omit to leave the saved value unchanged.

paycheckDateYmdstring date

Date of first paycheck with new compensation updates

ratesLockedboolean nullable

Whether the cycle currency conversion rates are locked. When omitted, the stored value is preserved.

Response

Cycle updated successfully

object required

Changes

    • info

      api operation id 100b0cf8c5207b35697ff10370fd5fe1 removed and replaced with aa4131d3dc07d50e436a6ee960fad1a6

    • info

      added the new optional request property //

    • info

      added the new optional request property

    • info

      request property list-of-types was widened by adding types null to media type application/json

    • info

      request property // list-of-types was widened by adding types null to media type application/json

    • info

      request property list-of-types was widened by adding types null to media type application/json

    • info

      request property list-of-types was widened by adding types null to media type application/json

    • info

      request property list-of-types was widened by adding types null to media type application/json