v1

latestOpenAPI 3.1.02026-07-26294215839.4 KB
Goals
Public API

Create Goal Comment

Creates a new comment on a goal. The goal must belong to the specified employee. Returns the newly created comment object including its assigned ID.

OAuth Scopes: goal.write

post/api/v1/performance/employees/{employeeId}/goals/{goalId}/comments

Path parameters

employeeIdstring required

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

goalIdstring required

goalId is the goal ID for the specified employee.

Request body

textstring required

The text content of the comment.

Response

A goal comment object with the new goal comment ID.

idstring

The comment ID.

authorUserIdinteger

The user ID of the comment author.

createdAtstring

ISO 8601 UTC timestamp when the comment was created.

textstring

The text content of the comment.

canEditboolean

Whether the authenticated caller can edit this comment.

canDeleteboolean

Whether the authenticated caller can delete this comment.

Example response

{
  "createdAt": "2025-04-10T15:36:38Z"
}