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.

OAuth Scopes: goal.write

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

The internal employee ID of the employee the goal is associated with.

string
required
^\d+$

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 3 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 3 months ago