Goals API: Added support for goal cycles

The Goals API now supports goal cycles, enabling the retrieval of cycles linked to goals and weights for performance reviews.

About goal cycles and performance review weights

A goal cycle lets admins define a timeframe and assign weights to each goal, helping teams clearly understand which objectives matter most.

A goal's weight for performance review directly influences overall performance scores for employees when included in the performance review.

This feature helps ensure that both managers and employees are aligned on what matters most and how it will be measured.

What's new

The Goals API has been extended to support goal cycle management, enabling external systems to assign goals to cycles and align with organizational time periods, such as quarterly or annual reviews.

New endpoints:

• Get Goal Cycle Metadata – returns cycle schema metadata
• Search Goal Cycles – retrieves available goal cycles (no filtering)

Enhanced endpoints:

• Create goal – now accepts an optional cycleId field to assign a goal to a cycle
• Update goal – supports assigning, moving, or unassigning goals from a cycle via cycleId
• Search for goals – now includes cycleId and read-only performance reviewweight in responses
• Goals metadata – includes metadata definitions for cycleId and performance review weight fields

Behavior highlights:

• Goals can be assigned to cycles using a valid cycleId
• To move a goal to a different cycle, send a new cycleId in the update payload
• To unassign a goal from a cycle, set cycleId to null
• Weight is a read-only field, used for performance reviews only (does not impact goal progress). This field cannot be set via the API.

Security & validation:

• Only cycles accessible to the authenticated service user’s company can be assigned
• Using invalid or unauthorized cycleId values return validation errors

To learn more, see Goals reference guide.