DocumentationAPI Reference
API Reference

Update Goal Progress

put
https://{companyDomain}.bamboohr.com/api/v1/performance/employees//goals//progress

Update the progress percentage of a simple, non-milestone goal. Do not use this endpoint for goals that contain milestones; BambooHR derives percent complete for milestone-based goals from milestone completion and will reject manual percent updates with a 400 response (UPDATE_GOAL_WITH_MILESTONE_PROGRESS_ERROR). For milestone-based goals, use update-goal-milestone-progress to mark individual milestones complete or incomplete.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

employeeId is the employee ID with whom the goal is associated.

string
required

goalId is the goal ID for the specified employee.

Body Params

The updated progress for a simple goal. Provide percentComplete from 0–100. When percentComplete is 100, provide completionDate; when less than 100, omit completionDate or set it to null. This endpoint is rejected for goals with milestones — use update-goal-milestone-progress instead.

integer
required
0 to 100

The percentage of completion for the goal (0-100)

The date when the goal was completed in YYYY-MM-DD format. Required when percentComplete is 100.

Responses

Updated 2 months ago

Language
Credentials
:
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 2 months ago