> 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/comments.md).

# Comments

## GET /api/v1/employee/comments/{employeeId}

> Lists the comments visible by an 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":{"FeedbackType":{"type":"string","description":"Type of feedback","enum":["RECOGNITION","CONGRATULATION","SUGGESTION","INFORMATION","CRITICISM","OTHER","SCORE","ENPS","CLASSIFICATION_FOLLOWUP","QUESTION","SURVEY","ANNOUNCEMENT_COMMENT"]},"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"}}},"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/comments/{employeeId}":{"get":{"tags":["Comments"],"description":"Lists the comments visible by an employee","operationId":"getEmployeeCommentsForQuestion","parameters":[{"name":"questionId","in":"query","required":false,"schema":{"type":"string"}},{"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}},{"name":"pending","in":"query","required":false,"schema":{"type":"boolean","default":false}},{"name":"commentText","in":"query","required":false,"schema":{"type":"string"}},{"name":"wallId","in":"query","description":"Deprecated. Use hierarchyId + feedbackTypes instead; walls are superseded by explicit comment-timeline filters (HAP-1197).","required":false,"schema":{"type":"string"}},{"name":"containerId","in":"query","required":false,"schema":{"type":"string"}},{"name":"hierarchyId","in":"query","description":"Area filter: one or more hierarchy node ids. Each selected node includes its whole subtree. Intersected with the user's silo-visible areas.","required":false,"schema":{"type":"array","items":{"type":"string"}}},{"name":"feedbackTypes","in":"query","description":"Feedback type filter (multi-select). Applied as-is, intersected only with the company's privacy-mode restriction. When omitted, no type restriction is added (subject to the privacy mode).","required":false,"schema":{"type":"array","items":{"$ref":"#/components/schemas/FeedbackType"},"uniqueItems":true}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuestionCommentsDTO"}}}}}}}}}
```

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

> Add an After-vote comment

```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":{"EmployeeCommentRequestDTO":{"type":"object","description":"Request body to post a new employee comment (question or container context).","properties":{"questionId":{"type":"string","description":"Question ID when commenting in a question context"},"containerId":{"type":"string","description":"Feedback container ID when commenting in a container context"},"message":{"type":"string","description":"Comment text"},"date":{"type":"string","format":"date-time","description":"Optional date (server uses reception time if omitted)"},"feedbackType":{"$ref":"#/components/schemas/FeedbackType","description":"Feedback type (e.g. SUGGESTION, RECOGNITION)"},"additionalFields":{"type":"object","additionalProperties":{},"description":"Additional fields keyed by CommentAdditionalFields"},"privated":{"type":"boolean","description":"Whether the comment is private (visible only to managers)"},"notAnonymous":{"type":"boolean","description":"Whether the comment is signed (not anonymous)"}},"required":["feedbackType","message"]},"FeedbackType":{"type":"string","description":"Type of feedback","enum":["RECOGNITION","CONGRATULATION","SUGGESTION","INFORMATION","CRITICISM","OTHER","SCORE","ENPS","CLASSIFICATION_FOLLOWUP","QUESTION","SURVEY","ANNOUNCEMENT_COMMENT"]}}},"paths":{"/api/v1/employee/comments/{employeeId}":{"post":{"tags":["Comments"],"description":"Add an After-vote comment","operationId":"addEmployeeComment","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmployeeCommentRequestDTO"}}},"required":true},"responses":{"200":{"description":"OK"}}}}}}
```

## DELETE /api/v1/employee/comments/{employeeId}

> Delete the comment results of the current day

```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":{}},"paths":{"/api/v1/employee/comments/{employeeId}":{"delete":{"tags":["Comments"],"description":"Delete the comment results of the current day","operationId":"resetTodayVoteResults_1","responses":{"200":{"description":"OK"}}}}}}
```

## POST /api/v1/employee/comments/{employeeId}/{commentId}/reply

> Add a comment reply

```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":{"EmployeeCommentReplyRequestDTO":{"type":"object","description":"Request body to post a reply to an employee comment.","properties":{"message":{"type":"string","description":"Reply text"},"messageType":{"type":"integer","format":"int32","description":"Optional message type identifier"},"date":{"type":"string","format":"date-time","description":"Optional date (server uses reception time if omitted)"},"notAnonymous":{"type":"boolean","description":"Whether the reply is signed (not anonymous)"},"attachments":{"type":"array","description":"Optional attachments (e.g. images)","items":{"$ref":"#/components/schemas/ContentAttachment"}}},"required":["message"]},"ContentAttachment":{"type":"object","properties":{"type":{"type":"string","enum":["IMAGE","VIDEO","EXTERNAL_GIF"]},"mimeType":{"type":"string"},"base64":{"type":"string"},"fileURL":{"type":"string"}}},"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"]},"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"]},"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"]},"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"]},"QuestionType":{"type":"string","description":"Type of question used in company surveys or questionnaires","enum":["GENERAL","TOPIC","OPEN","RANGE"]},"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/comments/{employeeId}/{commentId}/reply":{"post":{"tags":["Comments"],"description":"Add a comment reply","operationId":"addEmployeeCommentReply","parameters":[{"name":"commentId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmployeeCommentReplyRequestDTO"}}},"required":true},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmployeeCommentDTO"}}}}}}}}}
```

## POST /api/v1/employee/comments/{employeeId}/{commentId}/reply/verify

> Checks a reply for moderation before posting

```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":{"EmployeeCommentReplyRequestDTO":{"type":"object","description":"Request body to post a reply to an employee comment.","properties":{"message":{"type":"string","description":"Reply text"},"messageType":{"type":"integer","format":"int32","description":"Optional message type identifier"},"date":{"type":"string","format":"date-time","description":"Optional date (server uses reception time if omitted)"},"notAnonymous":{"type":"boolean","description":"Whether the reply is signed (not anonymous)"},"attachments":{"type":"array","description":"Optional attachments (e.g. images)","items":{"$ref":"#/components/schemas/ContentAttachment"}}},"required":["message"]},"ContentAttachment":{"type":"object","properties":{"type":{"type":"string","enum":["IMAGE","VIDEO","EXTERNAL_GIF"]},"mimeType":{"type":"string"},"base64":{"type":"string"},"fileURL":{"type":"string"}}},"FeedbackVerificationResultDTO":{"type":"object","description":"Result of feedback verification/moderation: result type, moderation action, and optional message/suggestion.","properties":{"result":{"$ref":"#/components/schemas/VerificationResultType","description":"Verification result"},"moderationType":{"$ref":"#/components/schemas/ModerationType","description":"Moderation type applied"},"message":{"type":"string","description":"Optional message (e.g. reason for block)"},"suggestion":{"type":"string","description":"Optional suggestion for the user (e.g. when moderation type is SUGGESTION)"}}},"VerificationResultType":{"type":"string","description":"Verification outcome: VALID, INPROPER_IMAGE, INPROPER_TEXT, OTHER","enum":["VALID","INPROPER_IMAGE","INPROPER_TEXT","OTHER"]},"ModerationType":{"type":"string","description":"Moderation action: SUGGESTION (suggest change) or BLOCK","enum":["SUGGESTION","BLOCK"]}}},"paths":{"/api/v1/employee/comments/{employeeId}/{commentId}/reply/verify":{"post":{"tags":["Comments"],"description":"Checks a reply for moderation before posting","operationId":"verifyEmployeeCommentReply","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmployeeCommentReplyRequestDTO"}}},"required":true},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FeedbackVerificationResultDTO"}}}}}}}}}
```

## GET /api/v1/employee/comments/{employeeId}/{commentId}

> Convenience method for retrieves a single comment

```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":{"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"]},"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"]},"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"]},"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"]},"QuestionType":{"type":"string","description":"Type of question used in company surveys or questionnaires","enum":["GENERAL","TOPIC","OPEN","RANGE"]},"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/comments/{employeeId}/{commentId}":{"get":{"tags":["Comments"],"description":"Convenience method for retrieves a single comment","operationId":"getSingleEmployeeComment_1","parameters":[{"name":"commentId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmployeeCommentDTO"}}}}}}}}}
```

## GET /api/v1/employee/comments/{employeeId}/filters

> Recovers available filters for question

```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":{}},"paths":{"/api/v1/employee/comments/{employeeId}/filters":{"get":{"tags":["Comments"],"description":"Recovers available filters for question","operationId":"getEmployeeCommentsAvailableFilters","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}}},"deprecated":true}}}}
```

## GET /api/v1/employee/comments/{employeeId}/actions

> Recovers available actions for the question 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":{"QuestionCommentActionsDTO":{"type":"object","description":"Available comment actions for a question: pending counts, feedback level mode, supported reply types.","properties":{"pendingComments":{"type":"integer","format":"int64","description":"Number of pending comments"},"pendingReplies":{"type":"integer","format":"int64","description":"Number of pending replies"},"feedbackLevelMode":{"$ref":"#/components/schemas/FeedbackLevelMode","description":"Feedback level mode for this question"},"supportedReplyTypes":{"type":"array","description":"Reply types supported for this question","items":{"$ref":"#/components/schemas/ReplyTypeDTO"},"uniqueItems":true}}},"FeedbackLevelMode":{"type":"string","enum":["ANONYMOUS_OPEN","ANONYMOUS_ON_REPLY","ALL_CLOSED","NO_FEEDBACK"]},"ReplyTypeDTO":{"type":"object","description":"Reply type option: id, title, and image URL.","properties":{"id":{"type":"integer","format":"int32","description":"Reply type identifier"},"title":{"type":"string","description":"Display title"},"imageURL":{"type":"string","description":"URL of the image for this reply type"}}}}},"paths":{"/api/v1/employee/comments/{employeeId}/actions":{"get":{"tags":["Comments"],"description":"Recovers available actions for the question comments","operationId":"getEmployeeCommentsAvailableActions","parameters":[{"name":"questionId","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuestionCommentActionsDTO"}}}}}}}}}
```
