> For the complete documentation index, see [llms.txt](https://api-docs.myhappyforce.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://api-docs.myhappyforce.com/docs/api-reference/feedback.md).

# Feedback

## POST /api/v1/employee/feedback/{employeeId}

> Post Employee Feedback

```json
{"openapi":"3.1.0","info":{"title":"Happyforce API","version":"v1"},"tags":[],"servers":[{"url":"{url}","description":"API URL","variables":{"url":{"description":"API Environment","enum":["https://api.happyforce.com","https://staging.happyforce.com","http://localhost:9000"],"default":"https://api.happyforce.com"}}}],"security":[{"employeeAPISessionId":[]}],"components":{"securitySchemes":{},"schemas":{"RecognitionFeedbackDTO":{"allOf":[{"$ref":"#/components/schemas/AbstractFeedbackDTO"},{"type":"object","properties":{"valueId":{"type":"string","description":"Id of the value for the recognition"},"target":{"$ref":"#/components/schemas/FeedbackTargetDTO","description":"To who is targeted the recognition"}}}],"description":"Recognition request POST message","required":["message","notAnonymous","privated","target","type","valueId"]},"AbstractFeedbackDTO":{"type":"object","description":"Base class for feedback post messages","discriminator":{"propertyName":"type","mapping":{"CONGRATULATION":"#/components/schemas/StandardFeedbackDTO","SUGGESTION":"#/components/schemas/SuggestionFeedbackDTO","INFORMATION":"#/components/schemas/StandardFeedbackDTO","RECOGNITION":"#/components/schemas/RecognitionFeedbackDTO","CRITICISM":"#/components/schemas/SomethingIsWrongFeedbackDTO"}},"properties":{"type":{"$ref":"#/components/schemas/FeedbackType","description":"Type of the feedback","enum":["CONGRATULATION, SUGGESTION, INFORMATION, RECOGNITION, CRITICISM"]},"date":{"type":"string","format":"date-time","description":"Date of the Feedback. If not posted, Server will add the reception one"},"privated":{"type":"boolean","description":"Should this feedback be hidden an only visible for managers?. Check Feedback Types endpoint to see the different modes"},"notAnonymous":{"type":"boolean","description":"Should this feedback be signed?"},"message":{"type":"string","description":"Core message of the feedback"},"verificationToken":{"type":"string","description":"If the feedback type requires verification, a result token must be attached before publishing"},"attachments":{"type":"array","description":"Attachements of the feedback, like images, etc","items":{"$ref":"#/components/schemas/FeedbackAttachementDTO"}},"additionalFields":{"type":"object","additionalProperties":{}}},"required":["message","notAnonymous","privated","type"]},"FeedbackType":{"type":"string","description":"Type of feedback","enum":["RECOGNITION","CONGRATULATION","SUGGESTION","INFORMATION","CRITICISM","OTHER","SCORE","ENPS","CLASSIFICATION_FOLLOWUP","QUESTION","SURVEY","ANNOUNCEMENT_COMMENT"]},"FeedbackAttachementDTO":{"type":"object","description":"Attachment for feedback (image, etc.): type, mime type, base64 or file URL.","properties":{"type":{"type":"string","description":"Attachment type (e.g. IMAGE)","enum":["IMAGE","VIDEO","EXTERNAL_GIF"]},"mimeType":{"type":"string","description":"MIME type of the file"},"base64":{"type":"string","description":"Base64-encoded content (when uploading)"},"fileURL":{"type":"string","description":"URL of the file (when already stored)"}}},"FeedbackTargetDTO":{"type":"object","description":"To who is targeted this feedback?","properties":{"name":{"type":"string","description":"To who is targeted the recognition. Just for FREE_TARGET, LIST_FREE_TARGET"},"description":{"type":"string","description":"Description of the target: Area, Manager name, or Employee Name. Just for FREE_TARGET, LIST_FREE_TARGET"},"id":{"type":"string","description":"The ID to who is targeted the recognition. Just for FREE_TARGET, LIST_FREE_TARGET feedback types"},"type":{"$ref":"#/components/schemas/FeedbackTargetType","description":"Which target type is this? is directed to someone or to a team"}}},"FeedbackTargetType":{"type":"string","description":"Feedback target type","enum":["EMPLOYEE","MANAGER","HIERARCHY","FREE"]},"SomethingIsWrongFeedbackDTO":{"allOf":[{"$ref":"#/components/schemas/AbstractFeedbackDTO"},{"type":"object","properties":{"makesMeFeel":{"type":"string","description":"Feedback Wrap makes me field value. Expected to not be empty"},"howToSolve":{"type":"string","description":"Feedback Wrap How To Solve. Expected to not be empty"}}}],"description":"Something is Wrong Feedback Post message","required":["howToSolve","makesMeFeel","message","notAnonymous","privated","type"]},"StandardFeedbackDTO":{"allOf":[{"$ref":"#/components/schemas/AbstractFeedbackDTO"}],"description":"Standard message used for Congratulation, Information and any other Type","required":["message","notAnonymous","privated","type"]},"SuggestionFeedbackDTO":{"allOf":[{"$ref":"#/components/schemas/AbstractFeedbackDTO"},{"type":"object","properties":{"containerId":{"type":"string","description":"Initiative id where to post this suggestion"}}}],"description":"Suggestion Feedback Post message","required":["containerId","message","notAnonymous","privated","type"]}}},"paths":{"/api/v1/employee/feedback/{employeeId}":{"post":{"tags":["Feedback"],"description":"Post Employee Feedback","operationId":"postFeedback","requestBody":{"content":{"application/json":{"schema":{"description":"Feedback message to be posted by the logged employee","oneOf":[{"$ref":"#/components/schemas/RecognitionFeedbackDTO"},{"$ref":"#/components/schemas/SomethingIsWrongFeedbackDTO"},{"$ref":"#/components/schemas/StandardFeedbackDTO"},{"$ref":"#/components/schemas/SuggestionFeedbackDTO"}]}}},"required":true},"responses":{"200":{"description":"OK"}}}}}}
```

## GET /api/v1/employee/feedback/{employeeId}/types

> Retrieves available feedback types for this employee

```json
{"openapi":"3.1.0","info":{"title":"Happyforce API","version":"v1"},"tags":[],"servers":[{"url":"{url}","description":"API URL","variables":{"url":{"description":"API Environment","enum":["https://api.happyforce.com","https://staging.happyforce.com","http://localhost:9000"],"default":"https://api.happyforce.com"}}}],"security":[{"employeeAPISessionId":[]}],"components":{"securitySchemes":{},"schemas":{"RecognitionFeedbackTypeDTO":{"type":"object","allOf":[{"$ref":"#/components/schemas/AbstractFeedbackTypeDTO"},{"type":"object","properties":{"values":{"type":"array","description":"List of recognition values (badges, categories) available for this feedback type","items":{"$ref":"#/components/schemas/RecognitionValueDTO"}}}}],"description":"Configuration for RECOGNITION feedback type. Includes list of recognition values (e.g. badges) that can be selected.","required":["type"]},"AbstractFeedbackTypeDTO":{"type":"object","description":"Base configuration for a feedback type (e.g. RECOGNITION, SUGGESTION). Defines privacy, signature, target mode, attachments, verification, and limits.","properties":{"type":{"$ref":"#/components/schemas/FeedbackType","description":"Feedback type identifier (e.g. RECOGNITION, SUGGESTION, CRITICISM)"},"privateMode":{"$ref":"#/components/schemas/FeedbackPrivacyMode","description":"Privacy mode for this feedback type"},"signatureMode":{"$ref":"#/components/schemas/SignatureMode","description":"Signature mode: ANONYMOUS, OPTIONAL, MANDATORY, etc."},"targetMode":{"$ref":"#/components/schemas/FeedbackTargetMode","description":"Target mode (e.g. free target, hierarchy)"},"allowedAttachementTypes":{"type":"array","description":"Allowed attachment types for comments of this feedback type","items":{"type":"string","enum":["IMAGE","VIDEO","EXTERNAL_GIF"]},"uniqueItems":true},"requiresVerification":{"type":"boolean","description":"Whether comments of this type require verification before publishing"},"maxLength":{"type":"integer","format":"int32","description":"Maximum allowed length for the message"},"imageURL":{"type":"string","description":"URL of the image/icon representing this feedback type"},"feedbackLevelMode":{"$ref":"#/components/schemas/FeedbackLevelMode","description":"Feedback level mode configuration"},"availableCommentCount":{"type":"integer","format":"int64","description":"Number of comments still available for the user in this feedback type"},"defaultSignatureMode":{"$ref":"#/components/schemas/DefaultSignatureType","description":"Default signature mode for this feedback type. Indicates whether the anonymous toggle should default to SIGNED (non-anonymous) or ANONYMOUS"}},"required":["type"]},"FeedbackType":{"type":"string","description":"Type of feedback","enum":["RECOGNITION","CONGRATULATION","SUGGESTION","INFORMATION","CRITICISM","OTHER","SCORE","ENPS","CLASSIFICATION_FOLLOWUP","QUESTION","SURVEY","ANNOUNCEMENT_COMMENT"]},"FeedbackPrivacyMode":{"type":"string","enum":["OPEN","OPTIONAL","MANDATORY"]},"SignatureMode":{"type":"string","enum":["ANONYMOUS","OPTIONAL","MANDATORY","PUBLIC_MANDATORY"]},"FeedbackTargetMode":{"type":"string","description":"FeedbackTargetMode.","enum":["NO_TARGET","FREE_TARGET","LIST_TARGET","LIST_FREE_TARGET"]},"FeedbackLevelMode":{"type":"string","enum":["ANONYMOUS_OPEN","ANONYMOUS_ON_REPLY","ALL_CLOSED","NO_FEEDBACK"]},"DefaultSignatureType":{"type":"string","description":"Default signature mode for feedback types. SIGNED means the comment will be non-anonymous by default, ANONYMOUS means it will be anonymous by default.","enum":["SIGNED","ANONYMOUS"]},"RecognitionValueDTO":{"type":"object","properties":{"id":{"type":"string"},"name":{"$ref":"#/components/schemas/MultiLanguage"},"iconImagePath":{"type":"string"}}},"MultiLanguage":{"type":"object","description":"A translatable text value: a required default value plus optional per-language overrides keyed by language tag (e.g. \"es\", \"en\", \"pt-BR\"). Consumers resolve the user's language from langValues (falling back to the base language, then to defaultValue).","properties":{"defaultValue":{"type":"string","description":"Fallback text used when there is no entry in langValues for the requested language.","minLength":1},"langValues":{"type":"object","additionalProperties":{"type":"string"},"description":"Per-language overrides keyed by language tag (e.g. \"es\", \"en\", \"pt-BR\")."},"valid":{"type":"boolean"}},"required":["defaultValue"]},"StandardFeedbackTypeDTO":{"type":"object","allOf":[{"$ref":"#/components/schemas/AbstractFeedbackTypeDTO"}],"description":"Configuration for standard feedback types (e.g. SUGGESTION, CONGRATULATION, CRITICISM).","required":["type"]}}},"paths":{"/api/v1/employee/feedback/{employeeId}/types":{"get":{"tags":["Feedback"],"description":"Retrieves available feedback types for this employee","operationId":"getFeedbackTypes","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"oneOf":[{"$ref":"#/components/schemas/RecognitionFeedbackTypeDTO"},{"$ref":"#/components/schemas/StandardFeedbackTypeDTO"}]}}}}}},"deprecated":true}}}}
```

## GET /api/v1/employee/feedback/{employeeId}/target/{feedbackType}

> Retrieves feedback Targets

```json
{"openapi":"3.1.0","info":{"title":"Happyforce API","version":"v1"},"tags":[],"servers":[{"url":"{url}","description":"API URL","variables":{"url":{"description":"API Environment","enum":["https://api.happyforce.com","https://staging.happyforce.com","http://localhost:9000"],"default":"https://api.happyforce.com"}}}],"security":[{"employeeAPISessionId":[]}],"components":{"securitySchemes":{},"schemas":{"FeedbackType":{"type":"string","description":"Type of feedback","enum":["RECOGNITION","CONGRATULATION","SUGGESTION","INFORMATION","CRITICISM","OTHER","SCORE","ENPS","CLASSIFICATION_FOLLOWUP","QUESTION","SURVEY","ANNOUNCEMENT_COMMENT"]},"FeedbackTargetGroupDTO":{"type":"object","description":"Group of feedback targets (e.g. hierarchy or list of people).","properties":{"id":{"type":"string","description":"Unique identifier of the target group"},"name":{"type":"string","description":"Display name of the group"},"type":{"$ref":"#/components/schemas/FeedbackTargetType","description":"Target type (e.g. hierarchy, free target)"},"targets":{"type":"array","description":"List of targets in this group","items":{"$ref":"#/components/schemas/FeedbackTargetDTO"}}}},"FeedbackTargetType":{"type":"string","description":"Feedback target type","enum":["EMPLOYEE","MANAGER","HIERARCHY","FREE"]},"FeedbackTargetDTO":{"type":"object","description":"To who is targeted this feedback?","properties":{"name":{"type":"string","description":"To who is targeted the recognition. Just for FREE_TARGET, LIST_FREE_TARGET"},"description":{"type":"string","description":"Description of the target: Area, Manager name, or Employee Name. Just for FREE_TARGET, LIST_FREE_TARGET"},"id":{"type":"string","description":"The ID to who is targeted the recognition. Just for FREE_TARGET, LIST_FREE_TARGET feedback types"},"type":{"$ref":"#/components/schemas/FeedbackTargetType","description":"Which target type is this? is directed to someone or to a team"}}}}},"paths":{"/api/v1/employee/feedback/{employeeId}/target/{feedbackType}":{"get":{"tags":["Feedback"],"description":"Retrieves feedback Targets","operationId":"getFeedbackTarget","parameters":[{"name":"feedbackType","in":"path","required":true,"schema":{"$ref":"#/components/schemas/FeedbackType"}},{"name":"text","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/FeedbackTargetGroupDTO"}}}}}},"deprecated":true}}}}
```

## GET /api/v1/employee/feedback/{employeeId}/status

> Get's feedback pending unread comments

```json
{"openapi":"3.1.0","info":{"title":"Happyforce API","version":"v1"},"tags":[],"servers":[{"url":"{url}","description":"API URL","variables":{"url":{"description":"API Environment","enum":["https://api.happyforce.com","https://staging.happyforce.com","http://localhost:9000"],"default":"https://api.happyforce.com"}}}],"security":[{"employeeAPISessionId":[]}],"components":{"securitySchemes":{},"schemas":{"FeedbackStatusDTO":{"type":"object","description":"Count of unread comments: private and public.","properties":{"unreadPrivate":{"type":"integer","format":"int32","description":"Number of unread private comments"},"unreadPublic":{"type":"integer","format":"int32","description":"Number of unread public comments"}}}}},"paths":{"/api/v1/employee/feedback/{employeeId}/status":{"get":{"tags":["Feedback"],"description":"Get's feedback pending unread comments","operationId":"getFeedbackCountStatus","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FeedbackStatusDTO"}}}}}}}}}
```

## GET /api/v1/employee/feedback/{employeeId}/private

> Retrieves the private feedback for a given user

```json
{"openapi":"3.1.0","info":{"title":"Happyforce API","version":"v1"},"tags":[],"servers":[{"url":"{url}","description":"API URL","variables":{"url":{"description":"API Environment","enum":["https://api.happyforce.com","https://staging.happyforce.com","http://localhost:9000"],"default":"https://api.happyforce.com"}}}],"security":[{"employeeAPISessionId":[]}],"components":{"securitySchemes":{},"schemas":{"QuestionCommentsDTO":{"type":"object","description":"Paginated list of comments for a question, with question info and range (from, to, total).","properties":{"question":{"$ref":"#/components/schemas/QuestionDTO","description":"The question these comments belong to"},"from":{"type":"integer","format":"int32","description":"Start index of the returned page"},"to":{"type":"integer","format":"int32","description":"End index of the returned page"},"total":{"type":"integer","format":"int64","description":"Total number of comments"},"comments":{"type":"array","description":"List of comments in this page","items":{"$ref":"#/components/schemas/EmployeeCommentDTO"}}}},"QuestionDTO":{"type":"object","description":"The details of the question to be created","properties":{"id":{"type":"string"},"title":{"$ref":"#/components/schemas/MultiLanguage"},"primary":{"type":"boolean"},"createdOn":{"type":"string","format":"date-time"},"activationDate":{"type":"string","format":"date-time"},"createdBy":{"type":"string"},"updatedBy":{"type":"string"},"questionType":{"$ref":"#/components/schemas/QuestionType"},"hierarchyIds":{"type":"array","items":{"type":"string"},"uniqueItems":true},"characteristics":{"type":"array","items":{"oneOf":[{"$ref":"#/components/schemas/EmployeeCharacteristicValueBoolean"},{"$ref":"#/components/schemas/EmployeeCharacteristicValueDate"},{"$ref":"#/components/schemas/EmployeeCharacteristicValueList"},{"$ref":"#/components/schemas/EmployeeCharacteristicValueTree"}]},"uniqueItems":true},"groupIds":{"type":"array","items":{"type":"string"},"uniqueItems":true},"values":{"type":"array","items":{"$ref":"#/components/schemas/QuestionValue"},"uniqueItems":true},"resultValues":{"type":"array","items":{"$ref":"#/components/schemas/QuestionValue"},"uniqueItems":true},"notifyByPush":{"type":"boolean"},"notifyByMail":{"type":"boolean"},"notified":{"type":"boolean"},"privated":{"type":"boolean"},"nonAnonymous":{"type":"boolean"},"requireNotEmpty":{"type":"boolean","deprecated":true},"mandatory":{"type":"boolean","deprecated":true},"voteMode":{"$ref":"#/components/schemas/QuestionVoteMode"},"feedbackEnabled":{"type":"boolean"},"minSelection":{"type":"integer","format":"int32"},"maxSelection":{"type":"integer","format":"int32"},"status":{"$ref":"#/components/schemas/QuestionStatus"},"activationRule":{"$ref":"#/components/schemas/QuestionActivationRuleDTO"},"activations":{"type":"array","items":{"$ref":"#/components/schemas/QuestionActivationDTO"},"uniqueItems":true}}},"MultiLanguage":{"type":"object","description":"A translatable text value: a required default value plus optional per-language overrides keyed by language tag (e.g. \"es\", \"en\", \"pt-BR\"). Consumers resolve the user's language from langValues (falling back to the base language, then to defaultValue).","properties":{"defaultValue":{"type":"string","description":"Fallback text used when there is no entry in langValues for the requested language.","minLength":1},"langValues":{"type":"object","additionalProperties":{"type":"string"},"description":"Per-language overrides keyed by language tag (e.g. \"es\", \"en\", \"pt-BR\")."},"valid":{"type":"boolean"}},"required":["defaultValue"]},"QuestionType":{"type":"string","description":"Type of question used in company surveys or questionnaires","enum":["GENERAL","TOPIC","OPEN","RANGE"]},"EmployeeCharacteristicValueBoolean":{"allOf":[{"$ref":"#/components/schemas/EmployeeCharacteristicValueBase"},{"type":"object","properties":{"value":{"type":"boolean"}}}]},"EmployeeCharacteristicValueBase":{"type":"object","description":"Base class for employee characteristic values","discriminator":{"propertyName":"questionType","mapping":{"LIST":"#/components/schemas/EmployeeCharacteristicValueList","DATE":"#/components/schemas/EmployeeCharacteristicValueDate","BOOLEAN":"#/components/schemas/EmployeeCharacteristicValueBoolean","TREE":"#/components/schemas/EmployeeCharacteristicValueTree"}},"properties":{"characteristicId":{"type":"string"},"id":{"type":"string"},"questionType":{"$ref":"#/components/schemas/CharacteristicType"}}},"CharacteristicType":{"type":"string","description":"Type of segmentation characteristic","enum":["DATE","LIST","BOOLEAN","TREE"]},"EmployeeCharacteristicValueDate":{"allOf":[{"$ref":"#/components/schemas/EmployeeCharacteristicValueBase"},{"type":"object","properties":{"date":{"type":"string","format":"date-time"},"value":{"type":"string"}}}]},"EmployeeCharacteristicValueList":{"allOf":[{"$ref":"#/components/schemas/EmployeeCharacteristicValueBase"},{"type":"object","properties":{"value":{"type":"string"}}}]},"EmployeeCharacteristicValueTree":{"allOf":[{"$ref":"#/components/schemas/EmployeeCharacteristicValueBase"},{"type":"object","properties":{"value":{"type":"string"},"assignedPath":{"type":"array","items":{"type":"string"}},"assignedOn":{"type":"string","format":"date-time"}}}]},"QuestionValue":{"type":"object","properties":{"id":{"type":"integer","format":"int32"},"score":{"type":"integer","format":"int32"},"label":{"$ref":"#/components/schemas/MultiLanguage"},"imageUrl":{"type":"string"},"color":{"type":"string"}},"required":["id","label","score"]},"QuestionVoteMode":{"type":"string","description":"Modes of question voting in a survey or feedback form. Defines whether a question is mandatory, optional, or deferred.","enum":["MANDATORY","OPTIONAL","DEFERRED"]},"QuestionStatus":{"type":"string","description":"Status of a question in a survey or questionnaire","enum":["ANY","ACTIVE","PENDING","EXPIRED","PAUSED","ARCHIVED"]},"QuestionActivationRuleDTO":{"type":"object","properties":{"ruleType":{"$ref":"#/components/schemas/ActivationRuleType"},"from":{"type":"string","format":"date-time"},"to":{"type":"string","format":"date-time"},"cronExpression":{"type":"string"},"startAt":{"type":"string","format":"date-time"},"endAt":{"type":"string","format":"date-time"},"duration":{"type":"integer","format":"int32"}}},"ActivationRuleType":{"type":"string","description":"Type of activation rule for a survey or questionnaire","enum":["SINGLE","RECURRENT","CALENDAR","CONTINUOUS"]},"QuestionActivationDTO":{"type":"object","properties":{"from":{"type":"string","format":"date-time"},"to":{"type":"string","format":"date-time"}}},"EmployeeCommentDTO":{"allOf":[{"$ref":"#/components/schemas/BaseCommentDTO"},{"type":"object","properties":{"id":{"type":"string","description":"Unique identifier of the comment"},"date":{"type":"string","format":"date-time","description":"Date and time when the comment was created"},"comment":{"type":"string","description":"Comment text content"},"hierarchy":{"$ref":"#/components/schemas/EmployeeHierarchyDTO","description":"Hierarchy information of the comment author (may be anonymized)"},"likes":{"type":"integer","format":"int32","description":"Number of likes received"},"liked":{"type":"boolean","description":"Whether the current user has liked this comment"},"dislikes":{"type":"integer","format":"int32","description":"Number of dislikes received"},"disliked":{"type":"boolean","description":"Whether the current user has disliked this comment"},"inappropriates":{"type":"integer","format":"int32","description":"Number of inappropriate flags"},"inappropriated":{"type":"boolean","description":"Whether the current user has flagged this as inappropriate"},"flaggedInapropriate":{"type":"boolean","description":"Whether this comment has been flagged as inappropriate"},"flaggedAnonymous":{"type":"boolean","description":"Whether the comment was posted anonymously"},"rating":{"type":"integer","format":"int32","description":"Optional rating value when the comment is tied to a question/score"},"questionValue":{"$ref":"#/components/schemas/QuestionValueDTO","description":"Question value when the comment is in a question or score context"},"signature":{"$ref":"#/components/schemas/SignatureDTO","description":"Signature information (anonymous or signed)"},"containerPreview":{"$ref":"#/components/schemas/FeedbackContainerPreviewDTO","description":"Preview of the feedback container this comment belongs to"},"html":{"type":"boolean","description":"Whether the comment content is HTML"},"sourceComment":{"type":"string","description":"Original comment text when edited or from another source"},"allowLike":{"type":"boolean","description":"Whether the current user can like this comment"},"allowDislike":{"type":"boolean","description":"Whether the current user can dislike this comment"},"allowFlagInappropriate":{"type":"boolean","description":"Whether the current user can flag this comment as inappropriate"},"feedbackType":{"$ref":"#/components/schemas/CommentFeedbackTypeDTO","deprecated":true,"description":"Deprecated. Feedback type classification for this comment."},"additionalFields":{"type":"object","additionalProperties":{},"description":"Additional fields keyed by CommentAdditionalFields enum"},"attachments":{"type":"array","description":"Attachments (e.g. images) linked to this comment","items":{"$ref":"#/components/schemas/EmployeeCommentAttachmentDTO"}},"hasBeenSeen":{"type":"boolean","description":"Whether this comment has been seen by the current user"},"questionId":{"type":"string","description":"Question ID when the comment is in a question context"},"announcementNumber":{"type":"string","deprecated":true,"description":"Deprecated. Announcement number reference."},"conversationId":{"type":"string","description":"Conversation ID if this comment started or belongs to a conversation"},"hasConversation":{"type":"boolean","description":"Whether this comment already has a conversation. Only sent to the comment author and to users with permissions on the comment's company."},"conversationOwned":{"type":"boolean","description":"Whether the user is the manager assigned to this comment's conversation (same as the conversation's owned flag). Only sent when hasConversation is true."},"conversationUpdated":{"type":"boolean","description":"Whether the conversation has activity the user has not seen (same as the conversation's updated flag). Only sent together with conversationId."},"replied":{"type":"boolean","description":"Whether this comment has been replied to"},"allowReply":{"type":"boolean","description":"Whether replies are allowed for this comment"},"requiresReplyVerification":{"type":"boolean","description":"Whether a reply must pass verification/moderation before being published"},"replySignatureMode":{"$ref":"#/components/schemas/SignatureMode","description":"Signature mode required for replies (e.g. ANONYMOUS, MANDATORY)"},"allowNotAnonymousReply":{"type":"boolean","deprecated":true,"description":"Deprecated. Replaced by replySignatureMode and other flags."},"allowStartConversation":{"type":"boolean","description":"Whether the user can start a conversation from this comment"},"allowedReplyAttachmentTypes":{"type":"array","description":"Attachment types allowed when replying (e.g. IMAGE)","items":{"type":"string","enum":["IMAGE","VIDEO","EXTERNAL_GIF"]},"uniqueItems":true},"replies":{"type":"array","description":"List of replies to this comment","items":{"$ref":"#/components/schemas/EmployeeCommentReplyDTO"}},"target":{"$ref":"#/components/schemas/FeedbackTargetDTO","description":"Target (e.g. hierarchy or group) this comment is associated with"},"status":{"$ref":"#/components/schemas/FeedbackCycleStatusDTO","description":"Status of the feedback cycle this comment belongs to"},"context":{"description":"Context of the comment (e.g. SURVEY, QUESTION, ANNOUNCEMENT) with type-specific data","oneOf":[{"$ref":"#/components/schemas/AnnouncementCommentContextDTO"},{"$ref":"#/components/schemas/ENPSContextDTO"},{"$ref":"#/components/schemas/QuestionContextDTO"},{"$ref":"#/components/schemas/ScoreContextDTO"},{"$ref":"#/components/schemas/SurveyContextDTO"}]}}}],"description":"Top-level employee comment. Extends base comment with question/conversation ids, reply settings, target, status, and context."},"BaseCommentDTO":{"type":"object","description":"Base class for all types of comments","discriminator":{"propertyName":"feedbackType","mapping":{"RECOGNITION":"#/components/schemas/RecognitionCommentDTO","SUGGESTION":"#/components/schemas/StandardCommentDTO","INFORMATION":"#/components/schemas/StandardCommentDTO","CRITICISM":"#/components/schemas/SomethingIsWrongCommentDTO","OTHER":"#/components/schemas/StandardCommentDTO","CONGRATULATION":"#/components/schemas/StandardCommentDTO","SCORE":"#/components/schemas/ScoreFeedbackCommentDTO","ENPS":"#/components/schemas/ENPSFeedbackCommentDTO","CLASSIFICATION_FOLLOWUP":"#/components/schemas/ClassificationFeedbackDTO","QUESTION":"#/components/schemas/QuestionFeedbackCommentDTO","SURVEY":"#/components/schemas/SurveyFeedbackCommentDTO","ANNOUNCEMENT_COMMENT":"#/components/schemas/AnnouncementFeedbackCommentDTO"}},"oneOf":[{"$ref":"#/components/schemas/RecognitionCommentDTO"},{"$ref":"#/components/schemas/StandardCommentDTO"},{"$ref":"#/components/schemas/SomethingIsWrongCommentDTO"},{"$ref":"#/components/schemas/ScoreFeedbackCommentDTO"},{"$ref":"#/components/schemas/ENPSFeedbackCommentDTO"},{"$ref":"#/components/schemas/ClassificationFeedbackDTO"},{"$ref":"#/components/schemas/QuestionFeedbackCommentDTO"},{"$ref":"#/components/schemas/SurveyFeedbackCommentDTO"},{"$ref":"#/components/schemas/AnnouncementFeedbackCommentDTO"}],"properties":{"id":{"type":"string"},"feedbackType":{"$ref":"#/components/schemas/FeedbackType"},"feedbackTypeImage":{"type":"string"},"privated":{"type":"boolean"},"date":{"type":"string","format":"date-time"},"comment":{"type":"string"},"hierarchyId":{"type":"string"},"hierarchyName":{"type":"string"},"hierarchyAnonymized":{"type":"boolean"},"flaggedAnonymous":{"type":"boolean"},"votes":{"type":"array","items":{"$ref":"#/components/schemas/QuestionValue"},"uniqueItems":true},"attachments":{"type":"array","items":{"$ref":"#/components/schemas/CommentAttachmentDTO"}},"allowStartConversation":{"type":"boolean"},"conversationOwnerId":{"type":"string"},"signerId":{"type":"string"},"conversationId":{"type":"string"},"hasBeenSeen":{"type":"boolean"},"allowPrivatedSwap":{"type":"boolean"}},"required":["feedbackType"]},"RecognitionCommentDTO":{"type":"object","allOf":[{"$ref":"#/components/schemas/StandardCommentDTO"},{"type":"object","properties":{"value":{"$ref":"#/components/schemas/RecognitionValueDTO"},"target":{"$ref":"#/components/schemas/CommentTargetDTO"}}},{"$ref":"#/components/schemas/BaseCommentDTO"}],"description":"RecognitionCommentDTO","required":["feedbackType"]},"StandardCommentDTO":{"allOf":[{"$ref":"#/components/schemas/BaseCommentDTO"},{"type":"object","properties":{"hrRelevant":{"type":"boolean"},"hrTags":{"type":"array","items":{"type":"string"},"uniqueItems":true},"sentimentScore":{"$ref":"#/components/schemas/EmployeeSentiment"},"entities":{"type":"array","items":{"$ref":"#/components/schemas/CommentTopic"}},"concepts":{"type":"array","items":{"$ref":"#/components/schemas/CommentTopic"}},"emotions":{"type":"object","additionalProperties":{"type":"number","format":"double"}},"personalities":{"type":"object","additionalProperties":{"type":"number","format":"double"}},"personas":{"type":"object","additionalProperties":{"type":"number","format":"double"}},"announcementId":{"type":"string"},"replies":{"type":"array","description":"List of replies to this comment","items":{"$ref":"#/components/schemas/CommentReplyDTO"}},"clusters":{"type":"array","items":{"$ref":"#/components/schemas/Cluster"}},"hrPositivenessClassification":{"$ref":"#/components/schemas/HR_POSSITIVENES_CLASSIFICATION"},"replied":{"type":"boolean"},"allowReply":{"type":"boolean"},"allowNonAnonymousReply":{"type":"boolean"},"originalPrivated":{"type":"boolean"},"privateStatusChangedById":{"type":"string"},"privateStatusChangedOn":{"type":"string","format":"date-time"},"allowTypeSwap":{"type":"boolean"},"likes":{"type":"integer","format":"int32"},"dislikes":{"type":"integer","format":"int32"},"inappropriate":{"type":"boolean"},"inappropriates":{"type":"integer","format":"int32"},"employeeInnappropiateFeedback":{"type":"array","items":{"$ref":"#/components/schemas/EmployeeInnappropiateFeedbackDTO"}},"inappropriateReasonType":{"$ref":"#/components/schemas/InappropriateReasonType"},"inappropriateSourceType":{"$ref":"#/components/schemas/InappropriateSourceType"},"commentRefereed":{"$ref":"#/components/schemas/CommentRefereed"},"inappropriateReason":{"type":"string"},"statuses":{"type":"array","items":{"$ref":"#/components/schemas/CommentStatusDTO"}},"container":{"$ref":"#/components/schemas/CommentContainerDTO"},"refereed":{"$ref":"#/components/schemas/CommentRefereedDTO"}}}],"description":"StandardCommentDTO","required":["feedbackType"]},"EmployeeSentiment":{"type":"object","properties":{"agreement":{"type":"boolean"},"ironic":{"type":"boolean"},"subjective":{"type":"boolean"},"score":{"type":"integer","format":"int32"},"positivity":{"type":"number","format":"double"}}},"CommentTopic":{"type":"object","properties":{"form":{"type":"string"},"relevance":{"type":"number","format":"double"},"type":{"type":"string"}}},"CommentReplyDTO":{"type":"object","description":"Comment reply with standard comment capabilities","properties":{"id":{"type":"string"},"feedbackType":{"$ref":"#/components/schemas/FeedbackType"},"feedbackTypeImage":{"type":"string"},"privated":{"type":"boolean"},"date":{"type":"string","format":"date-time"},"comment":{"type":"string"},"hierarchyId":{"type":"string"},"hierarchyName":{"type":"string"},"hierarchyAnonymized":{"type":"boolean"},"flaggedAnonymous":{"type":"boolean"},"votes":{"type":"array","items":{"$ref":"#/components/schemas/QuestionValue"},"uniqueItems":true},"attachments":{"type":"array","items":{"$ref":"#/components/schemas/CommentAttachmentDTO"}},"allowStartConversation":{"type":"boolean"},"conversationOwnerId":{"type":"string"},"signerId":{"type":"string"},"conversationId":{"type":"string"},"hasBeenSeen":{"type":"boolean"},"allowPrivatedSwap":{"type":"boolean"},"hrRelevant":{"type":"boolean"},"hrTags":{"type":"array","items":{"type":"string"},"uniqueItems":true},"sentimentScore":{"$ref":"#/components/schemas/EmployeeSentiment"},"entities":{"type":"array","items":{"$ref":"#/components/schemas/CommentTopic"}},"concepts":{"type":"array","items":{"$ref":"#/components/schemas/CommentTopic"}},"emotions":{"type":"object","additionalProperties":{"type":"number","format":"double"}},"personalities":{"type":"object","additionalProperties":{"type":"number","format":"double"}},"personas":{"type":"object","additionalProperties":{"type":"number","format":"double"}},"announcementId":{"type":"string"},"clusters":{"type":"array","items":{"$ref":"#/components/schemas/Cluster"}},"hrPositivenessClassification":{"$ref":"#/components/schemas/HR_POSSITIVENES_CLASSIFICATION"},"replied":{"type":"boolean"},"allowReply":{"type":"boolean"},"allowNonAnonymousReply":{"type":"boolean"},"originalPrivated":{"type":"boolean"},"privateStatusChangedById":{"type":"string"},"privateStatusChangedOn":{"type":"string","format":"date-time"},"allowTypeSwap":{"type":"boolean"},"likes":{"type":"integer","format":"int32"},"dislikes":{"type":"integer","format":"int32"},"inappropriate":{"type":"boolean"},"inappropriates":{"type":"integer","format":"int32"},"employeeInnappropiateFeedback":{"type":"array","items":{"$ref":"#/components/schemas/EmployeeInnappropiateFeedbackDTO"}},"inappropriateReasonType":{"$ref":"#/components/schemas/InappropriateReasonType"},"inappropriateSourceType":{"$ref":"#/components/schemas/InappropriateSourceType"},"commentRefereed":{"$ref":"#/components/schemas/CommentRefereed"},"inappropriateReason":{"type":"string"},"statuses":{"type":"array","items":{"$ref":"#/components/schemas/CommentStatusDTO"}},"container":{"$ref":"#/components/schemas/CommentContainerDTO"},"refereed":{"$ref":"#/components/schemas/CommentRefereedDTO"}}},"FeedbackType":{"type":"string","description":"Type of feedback","enum":["RECOGNITION","CONGRATULATION","SUGGESTION","INFORMATION","CRITICISM","OTHER","SCORE","ENPS","CLASSIFICATION_FOLLOWUP","QUESTION","SURVEY","ANNOUNCEMENT_COMMENT"]},"CommentAttachmentDTO":{"type":"object","properties":{"type":{"type":"string","enum":["IMAGE","VIDEO","EXTERNAL_GIF"]},"fileURL":{"type":"string"}}},"Cluster":{"type":"object","properties":{"title":{"type":"string"},"score":{"type":"number","format":"double"}}},"HR_POSSITIVENES_CLASSIFICATION":{"type":"string","enum":["POSITIVE","NEGATIVE","NEUTRAL"]},"EmployeeInnappropiateFeedbackDTO":{"type":"object","properties":{"date":{"type":"string","format":"date-time"},"type":{"$ref":"#/components/schemas/InappropriateReasonType"},"reason":{"type":"string"}}},"InappropriateReasonType":{"type":"string","enum":["THRESHOLD","OFFENSIVE","DISRESPECTFUL","OTHER"]},"InappropriateSourceType":{"type":"string","enum":["EMPLOYEES","USER"]},"CommentRefereed":{"type":"object","properties":{"userId":{"type":"string"},"date":{"type":"string","format":"date-time"}}},"CommentStatusDTO":{"type":"object","properties":{"statusTypeId":{"type":"string"},"date":{"type":"string","format":"date-time"},"userId":{"type":"string"},"current":{"type":"boolean"}}},"CommentContainerDTO":{"type":"object","properties":{"id":{"type":"string"},"title":{"$ref":"#/components/schemas/MultiLanguage"}}},"CommentRefereedDTO":{"type":"object","properties":{"userId":{"type":"string"},"date":{"type":"string","format":"date-time"}}},"RecognitionValueDTO":{"type":"object","properties":{"id":{"type":"string"},"name":{"$ref":"#/components/schemas/MultiLanguage"},"iconImagePath":{"type":"string"}}},"CommentTargetDTO":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"type":{"$ref":"#/components/schemas/FeedbackTargetType"}}},"FeedbackTargetType":{"type":"string","description":"Feedback target type","enum":["EMPLOYEE","MANAGER","HIERARCHY","FREE"]},"SomethingIsWrongCommentDTO":{"type":"object","allOf":[{"$ref":"#/components/schemas/StandardCommentDTO"},{"type":"object","properties":{"id":{"type":"string"},"feedbackType":{"$ref":"#/components/schemas/FeedbackType"},"feedbackTypeImage":{"type":"string"},"privated":{"type":"boolean"},"date":{"type":"string","format":"date-time"},"comment":{"type":"string"},"hierarchyId":{"type":"string"},"hierarchyName":{"type":"string"},"hierarchyAnonymized":{"type":"boolean"},"flaggedAnonymous":{"type":"boolean"},"votes":{"type":"array","items":{"$ref":"#/components/schemas/QuestionValue"},"uniqueItems":true},"attachments":{"type":"array","items":{"$ref":"#/components/schemas/CommentAttachmentDTO"}},"allowStartConversation":{"type":"boolean"},"conversationOwnerId":{"type":"string"},"signerId":{"type":"string"},"conversationId":{"type":"string"},"hasBeenSeen":{"type":"boolean"},"allowPrivatedSwap":{"type":"boolean"},"hrRelevant":{"type":"boolean"},"hrTags":{"type":"array","items":{"type":"string"},"uniqueItems":true},"sentimentScore":{"$ref":"#/components/schemas/EmployeeSentiment"},"entities":{"type":"array","items":{"$ref":"#/components/schemas/CommentTopic"}},"concepts":{"type":"array","items":{"$ref":"#/components/schemas/CommentTopic"}},"emotions":{"type":"object","additionalProperties":{"type":"number","format":"double"}},"personalities":{"type":"object","additionalProperties":{"type":"number","format":"double"}},"personas":{"type":"object","additionalProperties":{"type":"number","format":"double"}},"announcementId":{"type":"string"},"replies":{"type":"array","description":"List of replies to this comment","items":{"$ref":"#/components/schemas/CommentReplyDTO"}},"clusters":{"type":"array","items":{"$ref":"#/components/schemas/Cluster"}},"hrPositivenessClassification":{"$ref":"#/components/schemas/HR_POSSITIVENES_CLASSIFICATION"},"replied":{"type":"boolean"},"allowReply":{"type":"boolean"},"allowNonAnonymousReply":{"type":"boolean"},"originalPrivated":{"type":"boolean"},"privateStatusChangedById":{"type":"string"},"privateStatusChangedOn":{"type":"string","format":"date-time"},"allowTypeSwap":{"type":"boolean"},"likes":{"type":"integer","format":"int32"},"dislikes":{"type":"integer","format":"int32"},"inappropriate":{"type":"boolean"},"inappropriates":{"type":"integer","format":"int32"},"employeeInnappropiateFeedback":{"type":"array","items":{"$ref":"#/components/schemas/EmployeeInnappropiateFeedbackDTO"}},"inappropriateReasonType":{"$ref":"#/components/schemas/InappropriateReasonType"},"inappropriateSourceType":{"$ref":"#/components/schemas/InappropriateSourceType"},"commentRefereed":{"$ref":"#/components/schemas/CommentRefereed"},"inappropriateReason":{"type":"string"},"statuses":{"type":"array","items":{"$ref":"#/components/schemas/CommentStatusDTO"}},"container":{"$ref":"#/components/schemas/CommentContainerDTO"},"refereed":{"$ref":"#/components/schemas/CommentRefereedDTO"},"makesMeFeel":{"type":"string"},"howToSolve":{"type":"string"}}},{"$ref":"#/components/schemas/BaseCommentDTO"}],"description":"SomethingIsWrongCommentDTO","required":["feedbackType"]},"ScoreFeedbackCommentDTO":{"type":"object","allOf":[{"$ref":"#/components/schemas/BaseCommentDTO"},{"type":"object","properties":{"scoreId":{"type":"string"},"factorId":{"type":"string"},"questionId":{"type":"string"},"questionTitle":{"$ref":"#/components/schemas/MultiLanguage"},"scoreName":{"$ref":"#/components/schemas/MultiLanguage"},"factorName":{"$ref":"#/components/schemas/MultiLanguage"},"invertedQuestion":{"type":"boolean"}}}],"description":"ScoreFeedbackCommentDTO","required":["feedbackType"]},"ENPSFeedbackCommentDTO":{"type":"object","allOf":[{"$ref":"#/components/schemas/BaseCommentDTO"}],"description":"ENPSFeedbackCommentDTO","required":["feedbackType"]},"ClassificationFeedbackDTO":{"type":"object","allOf":[{"$ref":"#/components/schemas/BaseCommentDTO"},{"type":"object","properties":{"type":{"$ref":"#/components/schemas/EmployeeClassificationType"}}}],"description":"ClassificationFeedbackCommentDTO","required":["feedbackType"]},"EmployeeClassificationType":{"type":"string","description":"Type of employee classification based on their HI level","enum":["DISENGAGED","SLEEPING","DISENCHANTED","SAD","NEUTRAL","HAPPY","ENCHANTED"]},"QuestionFeedbackCommentDTO":{"type":"object","allOf":[{"$ref":"#/components/schemas/StandardCommentDTO"},{"type":"object","properties":{"id":{"type":"string"},"feedbackType":{"$ref":"#/components/schemas/FeedbackType"},"feedbackTypeImage":{"type":"string"},"privated":{"type":"boolean"},"date":{"type":"string","format":"date-time"},"comment":{"type":"string"},"hierarchyId":{"type":"string"},"hierarchyName":{"type":"string"},"hierarchyAnonymized":{"type":"boolean"},"flaggedAnonymous":{"type":"boolean"},"votes":{"type":"array","items":{"$ref":"#/components/schemas/QuestionValue"},"uniqueItems":true},"attachments":{"type":"array","items":{"$ref":"#/components/schemas/CommentAttachmentDTO"}},"allowStartConversation":{"type":"boolean"},"conversationOwnerId":{"type":"string"},"signerId":{"type":"string"},"conversationId":{"type":"string"},"hasBeenSeen":{"type":"boolean"},"allowPrivatedSwap":{"type":"boolean"},"hrRelevant":{"type":"boolean"},"hrTags":{"type":"array","items":{"type":"string"},"uniqueItems":true},"sentimentScore":{"$ref":"#/components/schemas/EmployeeSentiment"},"entities":{"type":"array","items":{"$ref":"#/components/schemas/CommentTopic"}},"concepts":{"type":"array","items":{"$ref":"#/components/schemas/CommentTopic"}},"emotions":{"type":"object","additionalProperties":{"type":"number","format":"double"}},"personalities":{"type":"object","additionalProperties":{"type":"number","format":"double"}},"personas":{"type":"object","additionalProperties":{"type":"number","format":"double"}},"announcementId":{"type":"string"},"replies":{"type":"array","description":"List of replies to this comment","items":{"$ref":"#/components/schemas/CommentReplyDTO"}},"clusters":{"type":"array","items":{"$ref":"#/components/schemas/Cluster"}},"hrPositivenessClassification":{"$ref":"#/components/schemas/HR_POSSITIVENES_CLASSIFICATION"},"replied":{"type":"boolean"},"allowReply":{"type":"boolean"},"allowNonAnonymousReply":{"type":"boolean"},"originalPrivated":{"type":"boolean"},"privateStatusChangedById":{"type":"string"},"privateStatusChangedOn":{"type":"string","format":"date-time"},"allowTypeSwap":{"type":"boolean"},"likes":{"type":"integer","format":"int32"},"dislikes":{"type":"integer","format":"int32"},"inappropriate":{"type":"boolean"},"inappropriates":{"type":"integer","format":"int32"},"employeeInnappropiateFeedback":{"type":"array","items":{"$ref":"#/components/schemas/EmployeeInnappropiateFeedbackDTO"}},"inappropriateReasonType":{"$ref":"#/components/schemas/InappropriateReasonType"},"inappropriateSourceType":{"$ref":"#/components/schemas/InappropriateSourceType"},"commentRefereed":{"$ref":"#/components/schemas/CommentRefereed"},"inappropriateReason":{"type":"string"},"statuses":{"type":"array","items":{"$ref":"#/components/schemas/CommentStatusDTO"}},"container":{"$ref":"#/components/schemas/CommentContainerDTO"},"refereed":{"$ref":"#/components/schemas/CommentRefereedDTO"},"questionId":{"type":"string"},"questionTitle":{"$ref":"#/components/schemas/MultiLanguage"}}},{"$ref":"#/components/schemas/BaseCommentDTO"}],"description":"QuestionFeedbackCommentDTO","required":["feedbackType"]},"SurveyFeedbackCommentDTO":{"type":"object","allOf":[{"$ref":"#/components/schemas/BaseCommentDTO"},{"type":"object","properties":{"questionId":{"type":"string"},"questionType":{"$ref":"#/components/schemas/QuestionType"},"surveyId":{"type":"string"},"roundId":{"type":"string"},"questionTitle":{"$ref":"#/components/schemas/MultiLanguage"}}}],"description":"SurveyFeedbackCommentDTO","required":["feedbackType"]},"AnnouncementFeedbackCommentDTO":{"type":"object","allOf":[{"$ref":"#/components/schemas/StandardCommentDTO"},{"type":"object","properties":{"id":{"type":"string"},"feedbackType":{"$ref":"#/components/schemas/FeedbackType"},"feedbackTypeImage":{"type":"string"},"privated":{"type":"boolean"},"date":{"type":"string","format":"date-time"},"comment":{"type":"string"},"hierarchyId":{"type":"string"},"hierarchyName":{"type":"string"},"hierarchyAnonymized":{"type":"boolean"},"flaggedAnonymous":{"type":"boolean"},"votes":{"type":"array","items":{"$ref":"#/components/schemas/QuestionValue"},"uniqueItems":true},"attachments":{"type":"array","items":{"$ref":"#/components/schemas/CommentAttachmentDTO"}},"allowStartConversation":{"type":"boolean"},"conversationOwnerId":{"type":"string"},"signerId":{"type":"string"},"conversationId":{"type":"string"},"hasBeenSeen":{"type":"boolean"},"allowPrivatedSwap":{"type":"boolean"},"hrRelevant":{"type":"boolean"},"hrTags":{"type":"array","items":{"type":"string"},"uniqueItems":true},"sentimentScore":{"$ref":"#/components/schemas/EmployeeSentiment"},"entities":{"type":"array","items":{"$ref":"#/components/schemas/CommentTopic"}},"concepts":{"type":"array","items":{"$ref":"#/components/schemas/CommentTopic"}},"emotions":{"type":"object","additionalProperties":{"type":"number","format":"double"}},"personalities":{"type":"object","additionalProperties":{"type":"number","format":"double"}},"personas":{"type":"object","additionalProperties":{"type":"number","format":"double"}},"announcementId":{"type":"string"},"replies":{"type":"array","description":"List of replies to this comment","items":{"$ref":"#/components/schemas/CommentReplyDTO"}},"clusters":{"type":"array","items":{"$ref":"#/components/schemas/Cluster"}},"hrPositivenessClassification":{"$ref":"#/components/schemas/HR_POSSITIVENES_CLASSIFICATION"},"replied":{"type":"boolean"},"allowReply":{"type":"boolean"},"allowNonAnonymousReply":{"type":"boolean"},"originalPrivated":{"type":"boolean"},"privateStatusChangedById":{"type":"string"},"privateStatusChangedOn":{"type":"string","format":"date-time"},"allowTypeSwap":{"type":"boolean"},"likes":{"type":"integer","format":"int32"},"dislikes":{"type":"integer","format":"int32"},"inappropriate":{"type":"boolean"},"inappropriates":{"type":"integer","format":"int32"},"employeeInnappropiateFeedback":{"type":"array","items":{"$ref":"#/components/schemas/EmployeeInnappropiateFeedbackDTO"}},"inappropriateReasonType":{"$ref":"#/components/schemas/InappropriateReasonType"},"inappropriateSourceType":{"$ref":"#/components/schemas/InappropriateSourceType"},"commentRefereed":{"$ref":"#/components/schemas/CommentRefereed"},"inappropriateReason":{"type":"string"},"statuses":{"type":"array","items":{"$ref":"#/components/schemas/CommentStatusDTO"}},"container":{"$ref":"#/components/schemas/CommentContainerDTO"},"refereed":{"$ref":"#/components/schemas/CommentRefereedDTO"}}},{"$ref":"#/components/schemas/BaseCommentDTO"}],"description":"AnnouncementFeedbackCommentDTO","required":["feedbackType"]},"EmployeeHierarchyDTO":{"type":"object","description":"Employee hierarchy node: id, parent id, name, and children (recursive structure).","properties":{"id":{"type":"string","description":"Hierarchy node identifier"},"parentId":{"type":"string","description":"Parent node identifier"},"name":{"type":"string","description":"Display name of the hierarchy node"},"children":{"type":"array","description":"Child nodes","items":{"description":"Employee hierarchy node: id, parent id, name, and children (recursive structure)."},"uniqueItems":true}}},"QuestionValueDTO":{"type":"object","description":"Option or value for a question (e.g. scale value, choice): id, score, value, image, color.","properties":{"id":{"type":"integer","format":"int32","description":"Value identifier"},"score":{"type":"integer","format":"int32","description":"Numeric score when applicable (e.g. for scales)"},"value":{"type":"string","description":"Display value (label)"},"imageUrl":{"type":"string","description":"URL of the image for this value"},"color":{"type":"string","description":"Color code for this value (e.g. for UI)"},"reflectionPrompt":{"type":"string","description":"Reflection prompt, in case the question has an additional comment option enabled"}}},"SignatureDTO":{"type":"object","description":"Signature (author) of a comment: id, name, description, and profile image.","properties":{"id":{"type":"string","description":"User ID of the signer"},"name":{"type":"string","description":"Display name of the signer"},"description":{"type":"string","description":"Optional description (e.g. role)"},"profileImagePath":{"type":"string","description":"URL or path to the profile image"}}},"FeedbackContainerPreviewDTO":{"type":"object","description":"Lightweight preview of a feedback container (id, type, title, image).","properties":{"id":{"type":"string","description":"Unique identifier of the container"},"type":{"$ref":"#/components/schemas/FeedbackContainerType","description":"Container type (e.g. IDEA_INITIATIVE)"},"title":{"type":"string","description":"Title of the container"},"imageUrl":{"type":"string","description":"URL of the container image"}}},"FeedbackContainerType":{"type":"string","enum":["IDEA_INITIATIVE"]},"CommentFeedbackTypeDTO":{"type":"object","deprecated":true,"description":"Deprecated. Feedback type with image URL. Use feedback-type-specific configuration instead.","properties":{"feedbackType":{"$ref":"#/components/schemas/FeedbackType","description":"Feedback type (e.g. RECOGNITION, SUGGESTION)"},"imageURL":{"type":"string","description":"URL of the image/icon for this feedback type"}}},"EmployeeCommentAttachmentDTO":{"type":"object","description":"Attachment linked to a comment (e.g. image) with type and file URL.","properties":{"type":{"type":"string","description":"Attachment type (e.g. IMAGE)","enum":["IMAGE","VIDEO","EXTERNAL_GIF"]},"fileURL":{"type":"string","description":"URL of the attached file"}}},"SignatureMode":{"type":"string","enum":["ANONYMOUS","OPTIONAL","MANDATORY","PUBLIC_MANDATORY"]},"EmployeeCommentReplyDTO":{"allOf":[{"$ref":"#/components/schemas/BaseCommentDTO"},{"type":"object","properties":{"id":{"type":"string","description":"Unique identifier of the comment"},"date":{"type":"string","format":"date-time","description":"Date and time when the comment was created"},"comment":{"type":"string","description":"Comment text content"},"hierarchy":{"$ref":"#/components/schemas/EmployeeHierarchyDTO","description":"Hierarchy information of the comment author (may be anonymized)"},"likes":{"type":"integer","format":"int32","description":"Number of likes received"},"liked":{"type":"boolean","description":"Whether the current user has liked this comment"},"dislikes":{"type":"integer","format":"int32","description":"Number of dislikes received"},"disliked":{"type":"boolean","description":"Whether the current user has disliked this comment"},"inappropriates":{"type":"integer","format":"int32","description":"Number of inappropriate flags"},"inappropriated":{"type":"boolean","description":"Whether the current user has flagged this as inappropriate"},"flaggedInapropriate":{"type":"boolean","description":"Whether this comment has been flagged as inappropriate"},"flaggedAnonymous":{"type":"boolean","description":"Whether the comment was posted anonymously"},"rating":{"type":"integer","format":"int32","description":"Optional rating value when the comment is tied to a question/score"},"questionValue":{"$ref":"#/components/schemas/QuestionValueDTO","description":"Question value when the comment is in a question or score context"},"signature":{"$ref":"#/components/schemas/SignatureDTO","description":"Signature information (anonymous or signed)"},"containerPreview":{"$ref":"#/components/schemas/FeedbackContainerPreviewDTO","description":"Preview of the feedback container this comment belongs to"},"html":{"type":"boolean","description":"Whether the comment content is HTML"},"sourceComment":{"type":"string","description":"Original comment text when edited or from another source"},"allowLike":{"type":"boolean","description":"Whether the current user can like this comment"},"allowDislike":{"type":"boolean","description":"Whether the current user can dislike this comment"},"allowFlagInappropriate":{"type":"boolean","description":"Whether the current user can flag this comment as inappropriate"},"feedbackType":{"$ref":"#/components/schemas/CommentFeedbackTypeDTO","deprecated":true,"description":"Deprecated. Feedback type classification for this comment."},"additionalFields":{"type":"object","additionalProperties":{},"description":"Additional fields keyed by CommentAdditionalFields enum"},"attachments":{"type":"array","description":"Attachments (e.g. images) linked to this comment","items":{"$ref":"#/components/schemas/EmployeeCommentAttachmentDTO"}},"hasBeenSeen":{"type":"boolean","description":"Whether this comment has been seen by the current user"},"highlightScore":{"type":"integer","format":"int32","description":"Score used to highlight or order this reply"}}}],"description":"Reply to an employee comment. Extends base comment with highlight score for ordering/display."},"FeedbackTargetDTO":{"type":"object","description":"To who is targeted this feedback?","properties":{"name":{"type":"string","description":"To who is targeted the recognition. Just for FREE_TARGET, LIST_FREE_TARGET"},"description":{"type":"string","description":"Description of the target: Area, Manager name, or Employee Name. Just for FREE_TARGET, LIST_FREE_TARGET"},"id":{"type":"string","description":"The ID to who is targeted the recognition. Just for FREE_TARGET, LIST_FREE_TARGET feedback types"},"type":{"$ref":"#/components/schemas/FeedbackTargetType","description":"Which target type is this? is directed to someone or to a team"}}},"FeedbackCycleStatusDTO":{"type":"object","description":"Status of a feedback cycle: color, label, and description (e.g. approved, in review).","properties":{"color":{"type":"string","description":"Color code for the status (e.g. for UI)"},"label":{"type":"string","description":"Short label for the status"},"description":{"type":"string","description":"Description of the status"}}},"AnnouncementCommentContextDTO":{"allOf":[{"$ref":"#/components/schemas/AbstractCommentContextDTO"},{"type":"object","properties":{"announcementId":{"type":"string","description":"ID of the announcement this comment belongs to"}}}],"description":"Comment context when the comment is on an announcement."},"AbstractCommentContextDTO":{"type":"object","description":"Base class for comment context (survey, score, question, announcement, etc.). Discriminated by type.","discriminator":{"propertyName":"type","mapping":{"SURVEY":"#/components/schemas/SurveyContextDTO","SCORE":"#/components/schemas/ScoreContextDTO","ENPS":"#/components/schemas/ENPSContextDTO","QUESTION":"#/components/schemas/QuestionContextDTO","ANNOUNCEMENT":"#/components/schemas/AnnouncementCommentContextDTO"}},"properties":{"type":{"type":"string"}},"required":["type"]},"ENPSContextDTO":{"allOf":[{"$ref":"#/components/schemas/AbstractCommentContextDTO"},{"type":"object","properties":{"questionTitle":{"type":"string","description":"Title of the ENPS question"},"questionValue":{"$ref":"#/components/schemas/QuestionValueDTO","description":"Selected or displayed question value"}}}],"description":"Comment context when the comment is in an ENPS (eNPS) question context."},"QuestionContextDTO":{"allOf":[{"$ref":"#/components/schemas/AbstractCommentContextDTO"},{"type":"object","properties":{"questionTitle":{"type":"string","description":"Title of the question"},"questionValues":{"type":"array","description":"Question value options or selected values","items":{"$ref":"#/components/schemas/QuestionValueDTO"},"uniqueItems":true}}}],"description":"Comment context when the comment is on a question (e.g. HI, check-in)."},"ScoreContextDTO":{"allOf":[{"$ref":"#/components/schemas/AbstractCommentContextDTO"},{"type":"object","properties":{"scoreName":{"type":"string","description":"Name of the score"},"factorName":{"type":"string","description":"Name of the factor"},"questionTitle":{"type":"string","description":"Title of the question"},"questionValue":{"$ref":"#/components/schemas/QuestionValueDTO","description":"Question value for the score"}}}],"description":"Comment context when the comment is in a score (factor/question) context."},"SurveyContextDTO":{"allOf":[{"$ref":"#/components/schemas/AbstractCommentContextDTO"},{"type":"object","properties":{"roundTitle":{"type":"string","description":"Title of the survey round"},"questionTitle":{"type":"string","description":"Title of the survey question"},"questionValues":{"type":"array","description":"Question value options or selected values","items":{"$ref":"#/components/schemas/QuestionValueDTO"},"uniqueItems":true}}}],"description":"Comment context when the comment is in a survey (round title, question title, question values)."}}},"paths":{"/api/v1/employee/feedback/{employeeId}/private":{"get":{"tags":["Feedback"],"description":"Retrieves the private feedback for a given user","operationId":"getPrivateFeedback","parameters":[{"name":"from","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":0}},{"name":"to","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":10}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuestionCommentsDTO"}}}}}}}}}
```

## GET /api/v1/employee/feedback/{employeeId}/availableTypes

> Retrieves available feedback types for this employee

```json
{"openapi":"3.1.0","info":{"title":"Happyforce API","version":"v1"},"tags":[],"servers":[{"url":"{url}","description":"API URL","variables":{"url":{"description":"API Environment","enum":["https://api.happyforce.com","https://staging.happyforce.com","http://localhost:9000"],"default":"https://api.happyforce.com"}}}],"security":[{"employeeAPISessionId":[]}],"components":{"securitySchemes":{},"schemas":{"RecognitionFeedbackTypeDTO":{"type":"object","allOf":[{"$ref":"#/components/schemas/AbstractFeedbackTypeDTO"},{"type":"object","properties":{"values":{"type":"array","description":"List of recognition values (badges, categories) available for this feedback type","items":{"$ref":"#/components/schemas/RecognitionValueDTO"}}}}],"description":"Configuration for RECOGNITION feedback type. Includes list of recognition values (e.g. badges) that can be selected.","required":["type"]},"AbstractFeedbackTypeDTO":{"type":"object","description":"Base configuration for a feedback type (e.g. RECOGNITION, SUGGESTION). Defines privacy, signature, target mode, attachments, verification, and limits.","properties":{"type":{"$ref":"#/components/schemas/FeedbackType","description":"Feedback type identifier (e.g. RECOGNITION, SUGGESTION, CRITICISM)"},"privateMode":{"$ref":"#/components/schemas/FeedbackPrivacyMode","description":"Privacy mode for this feedback type"},"signatureMode":{"$ref":"#/components/schemas/SignatureMode","description":"Signature mode: ANONYMOUS, OPTIONAL, MANDATORY, etc."},"targetMode":{"$ref":"#/components/schemas/FeedbackTargetMode","description":"Target mode (e.g. free target, hierarchy)"},"allowedAttachementTypes":{"type":"array","description":"Allowed attachment types for comments of this feedback type","items":{"type":"string","enum":["IMAGE","VIDEO","EXTERNAL_GIF"]},"uniqueItems":true},"requiresVerification":{"type":"boolean","description":"Whether comments of this type require verification before publishing"},"maxLength":{"type":"integer","format":"int32","description":"Maximum allowed length for the message"},"imageURL":{"type":"string","description":"URL of the image/icon representing this feedback type"},"feedbackLevelMode":{"$ref":"#/components/schemas/FeedbackLevelMode","description":"Feedback level mode configuration"},"availableCommentCount":{"type":"integer","format":"int64","description":"Number of comments still available for the user in this feedback type"},"defaultSignatureMode":{"$ref":"#/components/schemas/DefaultSignatureType","description":"Default signature mode for this feedback type. Indicates whether the anonymous toggle should default to SIGNED (non-anonymous) or ANONYMOUS"}},"required":["type"]},"FeedbackType":{"type":"string","description":"Type of feedback","enum":["RECOGNITION","CONGRATULATION","SUGGESTION","INFORMATION","CRITICISM","OTHER","SCORE","ENPS","CLASSIFICATION_FOLLOWUP","QUESTION","SURVEY","ANNOUNCEMENT_COMMENT"]},"FeedbackPrivacyMode":{"type":"string","enum":["OPEN","OPTIONAL","MANDATORY"]},"SignatureMode":{"type":"string","enum":["ANONYMOUS","OPTIONAL","MANDATORY","PUBLIC_MANDATORY"]},"FeedbackTargetMode":{"type":"string","description":"FeedbackTargetMode.","enum":["NO_TARGET","FREE_TARGET","LIST_TARGET","LIST_FREE_TARGET"]},"FeedbackLevelMode":{"type":"string","enum":["ANONYMOUS_OPEN","ANONYMOUS_ON_REPLY","ALL_CLOSED","NO_FEEDBACK"]},"DefaultSignatureType":{"type":"string","description":"Default signature mode for feedback types. SIGNED means the comment will be non-anonymous by default, ANONYMOUS means it will be anonymous by default.","enum":["SIGNED","ANONYMOUS"]},"RecognitionValueDTO":{"type":"object","properties":{"id":{"type":"string"},"name":{"$ref":"#/components/schemas/MultiLanguage"},"iconImagePath":{"type":"string"}}},"MultiLanguage":{"type":"object","description":"A translatable text value: a required default value plus optional per-language overrides keyed by language tag (e.g. \"es\", \"en\", \"pt-BR\"). Consumers resolve the user's language from langValues (falling back to the base language, then to defaultValue).","properties":{"defaultValue":{"type":"string","description":"Fallback text used when there is no entry in langValues for the requested language.","minLength":1},"langValues":{"type":"object","additionalProperties":{"type":"string"},"description":"Per-language overrides keyed by language tag (e.g. \"es\", \"en\", \"pt-BR\")."},"valid":{"type":"boolean"}},"required":["defaultValue"]},"StandardFeedbackTypeDTO":{"type":"object","allOf":[{"$ref":"#/components/schemas/AbstractFeedbackTypeDTO"}],"description":"Configuration for standard feedback types (e.g. SUGGESTION, CONGRATULATION, CRITICISM).","required":["type"]}}},"paths":{"/api/v1/employee/feedback/{employeeId}/availableTypes":{"get":{"tags":["Feedback"],"description":"Retrieves available feedback types for this employee","operationId":"getAvailableFeedbackTypes","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"oneOf":[{"$ref":"#/components/schemas/RecognitionFeedbackTypeDTO"},{"$ref":"#/components/schemas/StandardFeedbackTypeDTO"}]}}}}}}}}}}
```
