DocumentationAPI Reference
API Reference

Delete Goal

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

Permanently deletes a goal for an employee. The goal must belong to the specified employee. Returns 204 with no response body on success. For natural-language requests that identify a goal by title or partial title, first call list-goals with filter=status-all and resolve exactly one matching goal. Do not delete if there are multiple matches or no match; ask for clarification or report that the goal was not found.

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

The exact goal ID for the specified employee. Do not infer this from a partial title unless you have resolved a single matching goal via list-goals.

Responses
204

The goal was successfully deleted.

403

The API user does not have permission to delete this goal.

404

The goalId is zero or non-positive after integer cast, or the goal was not found.

Updated 2 months ago

Language
Credentials
:
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here!

Updated 2 months ago