> 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/company-config-resource.md).

# Company Config Resource

## GET /api/v1/company/config

>

```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":[{"companyAPISessionId":[]}],"components":{"securitySchemes":{"companyAPISessionId":{"type":"apiKey","description":"SessionId","name":"SessionId","in":"header"}},"schemas":{"CompanyConfig":{"type":"object","properties":{"alertDays":{"type":"array","items":{"type":"integer","format":"int32"}},"alertHour":{"type":"integer","format":"int32"},"alertMinute":{"type":"integer","format":"int32"},"voteReminderDays":{"type":"array","items":{"type":"integer","format":"int32"}},"voteReminderTimeConfig":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/EngagementActionTimeConfig"}},"inappropiateThreshold":{"type":"integer","format":"int32"},"hiCalculationMode":{"type":"string","enum":["CLASSIC","POSITIVENESS","AVERAGES"]},"elapsedDaysSinceLastVote":{"type":"integer","format":"int32"},"minActiveEmployees":{"type":"integer","format":"int32"},"apiKey":{"type":"string"},"validDomains":{"type":"array","items":{"type":"string"},"uniqueItems":true},"domainPatternExclusions":{"type":"array","items":{"type":"string"},"uniqueItems":true},"renameManagerComentsHierarchy":{"type":"boolean"},"defaultLanguage":{"type":"string"},"supportedLanguages":{"type":"array","items":{"type":"string"},"uniqueItems":true},"sentimentalAnalyticsEnabled":{"type":"boolean"},"personalityAnalyticsEnabled":{"type":"boolean"},"timezone":{"type":"string"},"status":{"$ref":"#/components/schemas/CompanyAccountStatus"},"launchStatus":{"type":"string","enum":["CREATED","PRELAUNCH","LAUNCHED","CRUISE_SPEED"]},"source":{"type":"string","enum":["SELF_SERVICE","SALE","PARTNER_SALE"]},"plan":{"type":"string","enum":["TEST","TRIAL","SUBSCRIPTION"]},"blockReason":{"type":"string"},"blockedDate":{"type":"string","format":"date-time"},"blockerId":{"type":"string"},"startDate":{"type":"string","format":"date-time"},"resetProfileMode":{"type":"string","enum":["NEVER","EACH_30_DAYS","ALWAYS"]},"expireActivationCodes":{"type":"boolean"},"disabledEgagementNonActivatedMails":{"type":"boolean"},"disabledEmailManagersRanking":{"type":"boolean"},"monthlyReportOnlyForAdmins":{"type":"boolean","deprecated":true},"rolesForMonthlyReport":{"type":"array","items":{"type":"string","enum":["ADVISOR","ADMIN","RESPONSIBLE","PUBLIC","MANAGER","EMPLOYEE"]},"uniqueItems":true},"disableEngagementMails":{"type":"boolean"},"assetsOverrides":{"$ref":"#/components/schemas/CompanyConfigAssets"},"includeInBenchmark":{"type":"boolean"},"industryType":{"type":"string","enum":["ACCOMMODATION_AND_FOOT_SERVICES","ARTS_ENTERTAINMENT_RECREATION","COMPUTER_SOFTWARE_IT_SERVICES","CONSTRUCTION","EDUCATIONAL_SERVICES","FINANCIAL_SERVICES_INSURANCE","HEALTH_CARE_SOCIAL_ASSISTANCE","MANAGEMENT_CONSULTING","MANUFACTURING","MARKETING_ADVERTISING","NATURAL_RESOURCES","NON_PROFIT_ORGANIZATION","PROFESSIONAL_SCIENTIFIC_AND_TECHNICAL_SERVICES","PUBLIC_AND_GOVERMENT_ADMINISTRATION","REAL_ESTATE_RENTAL_AND_LEASING","TRANSPORTATION_AND_WAREHOUSING","UTILITIES_AND_SERVICES","WHOLESALE_AND_RETAIL_TRADE","OTHER"]},"jobEnvironment":{"type":"string","enum":["OFFICE","NON_DESKTOP","GEEK"]},"requireVoteToSeeResults":{"type":"boolean"},"overrideDepartmentWithCompanyName":{"type":"boolean"},"mailVoteFrequency":{"type":"string","enum":["DISABLED","EACH_WEEK","EACH_TWO_WEEKS"]},"overrideVoteImageWithFeedbackType":{"type":"boolean"},"appStyle":{"type":"string"},"enableClassificationFollowups":{"type":"boolean"},"enableAutoInvite":{"type":"boolean"},"autoInviteToken":{"type":"string"},"statsTransparencyMode":{"type":"string","enum":["MANAGERS","ALL"]},"announcementNotificationDays":{"type":"array","items":{"type":"integer","format":"int32"}},"announcementNotificationStartHour":{"type":"integer","format":"int32"},"announcementNotificationEndHour":{"type":"integer","format":"int32"},"questionNotificationDays":{"type":"array","items":{"type":"integer","format":"int32"}},"questionNotificationStartHour":{"type":"integer","format":"int32"},"questionNotificationEndHour":{"type":"integer","format":"int32"},"surveyNotificationDays":{"type":"array","items":{"type":"integer","format":"int32"}},"surveyNotificationStartHour":{"type":"integer","format":"int32"},"surveyNotificationEndHour":{"type":"integer","format":"int32"},"fakeEmployeeStats":{"type":"boolean"},"allowBlockUsers":{"type":"boolean"},"moodNotesOnHiEnabled":{"type":"boolean"},"timeRegistrationEnabled":{"type":"boolean"},"heroRequiredRole":{"type":"string","enum":["ADVISOR","ADMIN","RESPONSIBLE","PUBLIC","MANAGER","EMPLOYEE"]},"loginByAccessLinkOnly":{"type":"boolean","deprecated":true},"allowedLoginMethods":{"type":"array","items":{"type":"string","enum":["USER_PASSWORD","USER_ACCESS_LINK","GOOGLE_AUTH","MICROSOFT_AUTH","HP_AUTH","SSO_SAML2","SSO_OIDC"]},"uniqueItems":true},"votingFlow":{"type":"string","enum":["QUESTIONS","ANNOUNCEMENTS"]},"context":{"type":"string","deprecated":true},"lifeEventsReminderEnabled":{"type":"boolean"},"birthdayDayOffEnabled":{"type":"boolean"},"employeeHierarchyConfiguredByAdmins":{"type":"boolean"},"rataModeEnabled":{"type":"boolean"},"enableManagerMonthlyReport":{"type":"boolean"},"enableManagerAiMonthlyEmail":{"type":"boolean"},"enableManagerOverview":{"type":"boolean"},"enableAccountDiagnostician":{"type":"boolean"},"actionsEnabled":{"type":"boolean"},"rewardsEnabled":{"type":"boolean"},"enableActionCoordinator":{"type":"boolean"},"indexTerminology":{"$ref":"#/components/schemas/IndexTerminology","description":"Vocabulary the company uses for its engagement index. Null defaults to HAPPINESS so existing companies keep the historical wording."},"afterVoteMessages":{"$ref":"#/components/schemas/AfterVoteMessagesConfig","description":"Per-company custom texts for the after-vote celebration cards (birthday / work anniversary). Null means the company uses the default i18n texts."},"afterVoteQuoteMinProbability":{"type":"integer","format":"int32","description":"Minimum chance (0-100) of showing the after-vote fortune cookie. Acts as a floor over the adaptive chance; 100 means every day. Null means the adaptive chance only.","maximum":100,"minimum":0},"conversationsOnLoginEnabled":{"type":"boolean"},"conversationsDisplayMoment":{"$ref":"#/components/schemas/ConversationsDisplayMoment"},"managementFocusActivatedAt":{"type":"string","format":"date-time"},"managementFocusDraftConfirmedAt":{"type":"string","format":"date-time"},"managementFocusDraftConfirmedBy":{"type":"string"},"hfmeEnabled":{"type":"boolean"},"hfheroEnabled":{"type":"boolean"},"active":{"type":"boolean"},"blocked":{"type":"boolean"},"indexTerminologyOrDefault":{"$ref":"#/components/schemas/IndexTerminology"},"paused":{"type":"boolean"}}},"EngagementActionTimeConfig":{"type":"object","properties":{"hour":{"type":"integer","format":"int32"},"minute":{"type":"integer","format":"int32"}}},"CompanyAccountStatus":{"type":"string","description":"Status of a company account (active, blocked, paused)","enum":["ACTIVE","BLOCKED","PAUSED"]},"CompanyConfigAssets":{"type":"object","properties":{"productName":{"type":"string"},"productMailLogo":{"type":"string"},"productIosStoreURL":{"type":"string"},"productIpadosStoreURL":{"type":"string"},"productAndroidStoreURL":{"type":"string"},"productSlackInstallURL":{"type":"string"},"productMSTeamsInstallURL":{"type":"string"},"productWebClientURL":{"type":"string"},"productAppsURL":{"type":"string"},"unsubEmailURL":{"type":"string"},"notificationsApplicationId":{"type":"string"}},"required":["productAndroidStoreURL","productAppsURL","productIosStoreURL","productIpadosStoreURL","productMSTeamsInstallURL","productMailLogo","productName","productSlackInstallURL","productWebClientURL","unsubEmailURL"]},"IndexTerminology":{"type":"string","description":"Vocabulary a company uses for its engagement index. HAPPINESS keeps the historical \"Happiness Index\" wording (default for existing companies); WELLBEING shows the \"Wellbeing Index\" wording. Presentation only — it does not change how the index is computed.","enum":["HAPPINESS","WELLBEING"]},"AfterVoteMessagesConfig":{"type":"object","description":"Per-company custom texts for the after-vote celebration cards (birthday and work anniversary). Each field is a MultiLanguage value; any field left null (or a language missing from a MultiLanguage) falls back to the default i18n text. Bodies may include the '*|COMPANY|*' placeholder, replaced with the company name at render time.","properties":{"birthdayTitle":{"$ref":"#/components/schemas/MultiLanguage","description":"Custom title for the birthday after-vote card. Null falls back to the default i18n title."},"birthdayBody":{"$ref":"#/components/schemas/MultiLanguage","description":"Custom body for the birthday after-vote card. May contain the '*|COMPANY|*' placeholder. Null falls back to the default i18n body."},"workAnniversaryTitle":{"$ref":"#/components/schemas/MultiLanguage","description":"Custom title for the work anniversary after-vote card. Null falls back to the default i18n title."},"workAnniversaryBody":{"$ref":"#/components/schemas/MultiLanguage","description":"Custom body for the work anniversary after-vote card. May contain the '*|COMPANY|*' placeholder. Null falls back to the default i18n body."}}},"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"]},"ConversationsDisplayMoment":{"type":"string","enum":["BEFORE_VOTE","AFTER_VOTE"]}}},"paths":{"/api/v1/company/config":{"get":{"tags":["company-config-resource"],"operationId":"getCompanyCurrentCompanyConfig","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/CompanyConfig"}}}}}}}}}
```

## POST /api/v1/company/config

>

```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":[{"companyAPISessionId":[]}],"components":{"securitySchemes":{"companyAPISessionId":{"type":"apiKey","description":"SessionId","name":"SessionId","in":"header"}},"schemas":{"CompanyDTO":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"mainEmail":{"type":"string"},"mainAddress":{"type":"string"},"mainPhone":{"type":"string"},"imageUrl":{"type":"string"},"createdOn":{"type":"string","format":"date-time"},"status":{"$ref":"#/components/schemas/CompanyAccountStatus"},"launchStatus":{"type":"string","enum":["CREATED","PRELAUNCH","LAUNCHED","CRUISE_SPEED"]}}},"CompanyAccountStatus":{"type":"string","description":"Status of a company account (active, blocked, paused)","enum":["ACTIVE","BLOCKED","PAUSED"]}}},"paths":{"/api/v1/company/config":{"post":{"tags":["company-config-resource"],"operationId":"updateCompany","requestBody":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/CompanyDTO"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/CompanyDTO"}}}}}}}}}
```

## GET /api/v1/company/config/{companyId}

>

```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":[{"companyAPISessionId":[]}],"components":{"securitySchemes":{"companyAPISessionId":{"type":"apiKey","description":"SessionId","name":"SessionId","in":"header"}},"schemas":{"CompanyConfig":{"type":"object","properties":{"alertDays":{"type":"array","items":{"type":"integer","format":"int32"}},"alertHour":{"type":"integer","format":"int32"},"alertMinute":{"type":"integer","format":"int32"},"voteReminderDays":{"type":"array","items":{"type":"integer","format":"int32"}},"voteReminderTimeConfig":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/EngagementActionTimeConfig"}},"inappropiateThreshold":{"type":"integer","format":"int32"},"hiCalculationMode":{"type":"string","enum":["CLASSIC","POSITIVENESS","AVERAGES"]},"elapsedDaysSinceLastVote":{"type":"integer","format":"int32"},"minActiveEmployees":{"type":"integer","format":"int32"},"apiKey":{"type":"string"},"validDomains":{"type":"array","items":{"type":"string"},"uniqueItems":true},"domainPatternExclusions":{"type":"array","items":{"type":"string"},"uniqueItems":true},"renameManagerComentsHierarchy":{"type":"boolean"},"defaultLanguage":{"type":"string"},"supportedLanguages":{"type":"array","items":{"type":"string"},"uniqueItems":true},"sentimentalAnalyticsEnabled":{"type":"boolean"},"personalityAnalyticsEnabled":{"type":"boolean"},"timezone":{"type":"string"},"status":{"$ref":"#/components/schemas/CompanyAccountStatus"},"launchStatus":{"type":"string","enum":["CREATED","PRELAUNCH","LAUNCHED","CRUISE_SPEED"]},"source":{"type":"string","enum":["SELF_SERVICE","SALE","PARTNER_SALE"]},"plan":{"type":"string","enum":["TEST","TRIAL","SUBSCRIPTION"]},"blockReason":{"type":"string"},"blockedDate":{"type":"string","format":"date-time"},"blockerId":{"type":"string"},"startDate":{"type":"string","format":"date-time"},"resetProfileMode":{"type":"string","enum":["NEVER","EACH_30_DAYS","ALWAYS"]},"expireActivationCodes":{"type":"boolean"},"disabledEgagementNonActivatedMails":{"type":"boolean"},"disabledEmailManagersRanking":{"type":"boolean"},"monthlyReportOnlyForAdmins":{"type":"boolean","deprecated":true},"rolesForMonthlyReport":{"type":"array","items":{"type":"string","enum":["ADVISOR","ADMIN","RESPONSIBLE","PUBLIC","MANAGER","EMPLOYEE"]},"uniqueItems":true},"disableEngagementMails":{"type":"boolean"},"assetsOverrides":{"$ref":"#/components/schemas/CompanyConfigAssets"},"includeInBenchmark":{"type":"boolean"},"industryType":{"type":"string","enum":["ACCOMMODATION_AND_FOOT_SERVICES","ARTS_ENTERTAINMENT_RECREATION","COMPUTER_SOFTWARE_IT_SERVICES","CONSTRUCTION","EDUCATIONAL_SERVICES","FINANCIAL_SERVICES_INSURANCE","HEALTH_CARE_SOCIAL_ASSISTANCE","MANAGEMENT_CONSULTING","MANUFACTURING","MARKETING_ADVERTISING","NATURAL_RESOURCES","NON_PROFIT_ORGANIZATION","PROFESSIONAL_SCIENTIFIC_AND_TECHNICAL_SERVICES","PUBLIC_AND_GOVERMENT_ADMINISTRATION","REAL_ESTATE_RENTAL_AND_LEASING","TRANSPORTATION_AND_WAREHOUSING","UTILITIES_AND_SERVICES","WHOLESALE_AND_RETAIL_TRADE","OTHER"]},"jobEnvironment":{"type":"string","enum":["OFFICE","NON_DESKTOP","GEEK"]},"requireVoteToSeeResults":{"type":"boolean"},"overrideDepartmentWithCompanyName":{"type":"boolean"},"mailVoteFrequency":{"type":"string","enum":["DISABLED","EACH_WEEK","EACH_TWO_WEEKS"]},"overrideVoteImageWithFeedbackType":{"type":"boolean"},"appStyle":{"type":"string"},"enableClassificationFollowups":{"type":"boolean"},"enableAutoInvite":{"type":"boolean"},"autoInviteToken":{"type":"string"},"statsTransparencyMode":{"type":"string","enum":["MANAGERS","ALL"]},"announcementNotificationDays":{"type":"array","items":{"type":"integer","format":"int32"}},"announcementNotificationStartHour":{"type":"integer","format":"int32"},"announcementNotificationEndHour":{"type":"integer","format":"int32"},"questionNotificationDays":{"type":"array","items":{"type":"integer","format":"int32"}},"questionNotificationStartHour":{"type":"integer","format":"int32"},"questionNotificationEndHour":{"type":"integer","format":"int32"},"surveyNotificationDays":{"type":"array","items":{"type":"integer","format":"int32"}},"surveyNotificationStartHour":{"type":"integer","format":"int32"},"surveyNotificationEndHour":{"type":"integer","format":"int32"},"fakeEmployeeStats":{"type":"boolean"},"allowBlockUsers":{"type":"boolean"},"moodNotesOnHiEnabled":{"type":"boolean"},"timeRegistrationEnabled":{"type":"boolean"},"heroRequiredRole":{"type":"string","enum":["ADVISOR","ADMIN","RESPONSIBLE","PUBLIC","MANAGER","EMPLOYEE"]},"loginByAccessLinkOnly":{"type":"boolean","deprecated":true},"allowedLoginMethods":{"type":"array","items":{"type":"string","enum":["USER_PASSWORD","USER_ACCESS_LINK","GOOGLE_AUTH","MICROSOFT_AUTH","HP_AUTH","SSO_SAML2","SSO_OIDC"]},"uniqueItems":true},"votingFlow":{"type":"string","enum":["QUESTIONS","ANNOUNCEMENTS"]},"context":{"type":"string","deprecated":true},"lifeEventsReminderEnabled":{"type":"boolean"},"birthdayDayOffEnabled":{"type":"boolean"},"employeeHierarchyConfiguredByAdmins":{"type":"boolean"},"rataModeEnabled":{"type":"boolean"},"enableManagerMonthlyReport":{"type":"boolean"},"enableManagerAiMonthlyEmail":{"type":"boolean"},"enableManagerOverview":{"type":"boolean"},"enableAccountDiagnostician":{"type":"boolean"},"actionsEnabled":{"type":"boolean"},"rewardsEnabled":{"type":"boolean"},"enableActionCoordinator":{"type":"boolean"},"indexTerminology":{"$ref":"#/components/schemas/IndexTerminology","description":"Vocabulary the company uses for its engagement index. Null defaults to HAPPINESS so existing companies keep the historical wording."},"afterVoteMessages":{"$ref":"#/components/schemas/AfterVoteMessagesConfig","description":"Per-company custom texts for the after-vote celebration cards (birthday / work anniversary). Null means the company uses the default i18n texts."},"afterVoteQuoteMinProbability":{"type":"integer","format":"int32","description":"Minimum chance (0-100) of showing the after-vote fortune cookie. Acts as a floor over the adaptive chance; 100 means every day. Null means the adaptive chance only.","maximum":100,"minimum":0},"conversationsOnLoginEnabled":{"type":"boolean"},"conversationsDisplayMoment":{"$ref":"#/components/schemas/ConversationsDisplayMoment"},"managementFocusActivatedAt":{"type":"string","format":"date-time"},"managementFocusDraftConfirmedAt":{"type":"string","format":"date-time"},"managementFocusDraftConfirmedBy":{"type":"string"},"hfmeEnabled":{"type":"boolean"},"hfheroEnabled":{"type":"boolean"},"active":{"type":"boolean"},"blocked":{"type":"boolean"},"indexTerminologyOrDefault":{"$ref":"#/components/schemas/IndexTerminology"},"paused":{"type":"boolean"}}},"EngagementActionTimeConfig":{"type":"object","properties":{"hour":{"type":"integer","format":"int32"},"minute":{"type":"integer","format":"int32"}}},"CompanyAccountStatus":{"type":"string","description":"Status of a company account (active, blocked, paused)","enum":["ACTIVE","BLOCKED","PAUSED"]},"CompanyConfigAssets":{"type":"object","properties":{"productName":{"type":"string"},"productMailLogo":{"type":"string"},"productIosStoreURL":{"type":"string"},"productIpadosStoreURL":{"type":"string"},"productAndroidStoreURL":{"type":"string"},"productSlackInstallURL":{"type":"string"},"productMSTeamsInstallURL":{"type":"string"},"productWebClientURL":{"type":"string"},"productAppsURL":{"type":"string"},"unsubEmailURL":{"type":"string"},"notificationsApplicationId":{"type":"string"}},"required":["productAndroidStoreURL","productAppsURL","productIosStoreURL","productIpadosStoreURL","productMSTeamsInstallURL","productMailLogo","productName","productSlackInstallURL","productWebClientURL","unsubEmailURL"]},"IndexTerminology":{"type":"string","description":"Vocabulary a company uses for its engagement index. HAPPINESS keeps the historical \"Happiness Index\" wording (default for existing companies); WELLBEING shows the \"Wellbeing Index\" wording. Presentation only — it does not change how the index is computed.","enum":["HAPPINESS","WELLBEING"]},"AfterVoteMessagesConfig":{"type":"object","description":"Per-company custom texts for the after-vote celebration cards (birthday and work anniversary). Each field is a MultiLanguage value; any field left null (or a language missing from a MultiLanguage) falls back to the default i18n text. Bodies may include the '*|COMPANY|*' placeholder, replaced with the company name at render time.","properties":{"birthdayTitle":{"$ref":"#/components/schemas/MultiLanguage","description":"Custom title for the birthday after-vote card. Null falls back to the default i18n title."},"birthdayBody":{"$ref":"#/components/schemas/MultiLanguage","description":"Custom body for the birthday after-vote card. May contain the '*|COMPANY|*' placeholder. Null falls back to the default i18n body."},"workAnniversaryTitle":{"$ref":"#/components/schemas/MultiLanguage","description":"Custom title for the work anniversary after-vote card. Null falls back to the default i18n title."},"workAnniversaryBody":{"$ref":"#/components/schemas/MultiLanguage","description":"Custom body for the work anniversary after-vote card. May contain the '*|COMPANY|*' placeholder. Null falls back to the default i18n body."}}},"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"]},"ConversationsDisplayMoment":{"type":"string","enum":["BEFORE_VOTE","AFTER_VOTE"]}}},"paths":{"/api/v1/company/config/{companyId}":{"get":{"tags":["company-config-resource"],"operationId":"getCompanyConfig","parameters":[{"name":"companyId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/CompanyConfig"}}}}}}}}}
```

## POST /api/v1/company/config/{companyId}

>

```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":[{"companyAPISessionId":[]}],"components":{"securitySchemes":{"companyAPISessionId":{"type":"apiKey","description":"SessionId","name":"SessionId","in":"header"}},"schemas":{"CompanyConfig":{"type":"object","properties":{"alertDays":{"type":"array","items":{"type":"integer","format":"int32"}},"alertHour":{"type":"integer","format":"int32"},"alertMinute":{"type":"integer","format":"int32"},"voteReminderDays":{"type":"array","items":{"type":"integer","format":"int32"}},"voteReminderTimeConfig":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/EngagementActionTimeConfig"}},"inappropiateThreshold":{"type":"integer","format":"int32"},"hiCalculationMode":{"type":"string","enum":["CLASSIC","POSITIVENESS","AVERAGES"]},"elapsedDaysSinceLastVote":{"type":"integer","format":"int32"},"minActiveEmployees":{"type":"integer","format":"int32"},"apiKey":{"type":"string"},"validDomains":{"type":"array","items":{"type":"string"},"uniqueItems":true},"domainPatternExclusions":{"type":"array","items":{"type":"string"},"uniqueItems":true},"renameManagerComentsHierarchy":{"type":"boolean"},"defaultLanguage":{"type":"string"},"supportedLanguages":{"type":"array","items":{"type":"string"},"uniqueItems":true},"sentimentalAnalyticsEnabled":{"type":"boolean"},"personalityAnalyticsEnabled":{"type":"boolean"},"timezone":{"type":"string"},"status":{"$ref":"#/components/schemas/CompanyAccountStatus"},"launchStatus":{"type":"string","enum":["CREATED","PRELAUNCH","LAUNCHED","CRUISE_SPEED"]},"source":{"type":"string","enum":["SELF_SERVICE","SALE","PARTNER_SALE"]},"plan":{"type":"string","enum":["TEST","TRIAL","SUBSCRIPTION"]},"blockReason":{"type":"string"},"blockedDate":{"type":"string","format":"date-time"},"blockerId":{"type":"string"},"startDate":{"type":"string","format":"date-time"},"resetProfileMode":{"type":"string","enum":["NEVER","EACH_30_DAYS","ALWAYS"]},"expireActivationCodes":{"type":"boolean"},"disabledEgagementNonActivatedMails":{"type":"boolean"},"disabledEmailManagersRanking":{"type":"boolean"},"monthlyReportOnlyForAdmins":{"type":"boolean","deprecated":true},"rolesForMonthlyReport":{"type":"array","items":{"type":"string","enum":["ADVISOR","ADMIN","RESPONSIBLE","PUBLIC","MANAGER","EMPLOYEE"]},"uniqueItems":true},"disableEngagementMails":{"type":"boolean"},"assetsOverrides":{"$ref":"#/components/schemas/CompanyConfigAssets"},"includeInBenchmark":{"type":"boolean"},"industryType":{"type":"string","enum":["ACCOMMODATION_AND_FOOT_SERVICES","ARTS_ENTERTAINMENT_RECREATION","COMPUTER_SOFTWARE_IT_SERVICES","CONSTRUCTION","EDUCATIONAL_SERVICES","FINANCIAL_SERVICES_INSURANCE","HEALTH_CARE_SOCIAL_ASSISTANCE","MANAGEMENT_CONSULTING","MANUFACTURING","MARKETING_ADVERTISING","NATURAL_RESOURCES","NON_PROFIT_ORGANIZATION","PROFESSIONAL_SCIENTIFIC_AND_TECHNICAL_SERVICES","PUBLIC_AND_GOVERMENT_ADMINISTRATION","REAL_ESTATE_RENTAL_AND_LEASING","TRANSPORTATION_AND_WAREHOUSING","UTILITIES_AND_SERVICES","WHOLESALE_AND_RETAIL_TRADE","OTHER"]},"jobEnvironment":{"type":"string","enum":["OFFICE","NON_DESKTOP","GEEK"]},"requireVoteToSeeResults":{"type":"boolean"},"overrideDepartmentWithCompanyName":{"type":"boolean"},"mailVoteFrequency":{"type":"string","enum":["DISABLED","EACH_WEEK","EACH_TWO_WEEKS"]},"overrideVoteImageWithFeedbackType":{"type":"boolean"},"appStyle":{"type":"string"},"enableClassificationFollowups":{"type":"boolean"},"enableAutoInvite":{"type":"boolean"},"autoInviteToken":{"type":"string"},"statsTransparencyMode":{"type":"string","enum":["MANAGERS","ALL"]},"announcementNotificationDays":{"type":"array","items":{"type":"integer","format":"int32"}},"announcementNotificationStartHour":{"type":"integer","format":"int32"},"announcementNotificationEndHour":{"type":"integer","format":"int32"},"questionNotificationDays":{"type":"array","items":{"type":"integer","format":"int32"}},"questionNotificationStartHour":{"type":"integer","format":"int32"},"questionNotificationEndHour":{"type":"integer","format":"int32"},"surveyNotificationDays":{"type":"array","items":{"type":"integer","format":"int32"}},"surveyNotificationStartHour":{"type":"integer","format":"int32"},"surveyNotificationEndHour":{"type":"integer","format":"int32"},"fakeEmployeeStats":{"type":"boolean"},"allowBlockUsers":{"type":"boolean"},"moodNotesOnHiEnabled":{"type":"boolean"},"timeRegistrationEnabled":{"type":"boolean"},"heroRequiredRole":{"type":"string","enum":["ADVISOR","ADMIN","RESPONSIBLE","PUBLIC","MANAGER","EMPLOYEE"]},"loginByAccessLinkOnly":{"type":"boolean","deprecated":true},"allowedLoginMethods":{"type":"array","items":{"type":"string","enum":["USER_PASSWORD","USER_ACCESS_LINK","GOOGLE_AUTH","MICROSOFT_AUTH","HP_AUTH","SSO_SAML2","SSO_OIDC"]},"uniqueItems":true},"votingFlow":{"type":"string","enum":["QUESTIONS","ANNOUNCEMENTS"]},"context":{"type":"string","deprecated":true},"lifeEventsReminderEnabled":{"type":"boolean"},"birthdayDayOffEnabled":{"type":"boolean"},"employeeHierarchyConfiguredByAdmins":{"type":"boolean"},"rataModeEnabled":{"type":"boolean"},"enableManagerMonthlyReport":{"type":"boolean"},"enableManagerAiMonthlyEmail":{"type":"boolean"},"enableManagerOverview":{"type":"boolean"},"enableAccountDiagnostician":{"type":"boolean"},"actionsEnabled":{"type":"boolean"},"rewardsEnabled":{"type":"boolean"},"enableActionCoordinator":{"type":"boolean"},"indexTerminology":{"$ref":"#/components/schemas/IndexTerminology","description":"Vocabulary the company uses for its engagement index. Null defaults to HAPPINESS so existing companies keep the historical wording."},"afterVoteMessages":{"$ref":"#/components/schemas/AfterVoteMessagesConfig","description":"Per-company custom texts for the after-vote celebration cards (birthday / work anniversary). Null means the company uses the default i18n texts."},"afterVoteQuoteMinProbability":{"type":"integer","format":"int32","description":"Minimum chance (0-100) of showing the after-vote fortune cookie. Acts as a floor over the adaptive chance; 100 means every day. Null means the adaptive chance only.","maximum":100,"minimum":0},"conversationsOnLoginEnabled":{"type":"boolean"},"conversationsDisplayMoment":{"$ref":"#/components/schemas/ConversationsDisplayMoment"},"managementFocusActivatedAt":{"type":"string","format":"date-time"},"managementFocusDraftConfirmedAt":{"type":"string","format":"date-time"},"managementFocusDraftConfirmedBy":{"type":"string"},"hfmeEnabled":{"type":"boolean"},"hfheroEnabled":{"type":"boolean"},"active":{"type":"boolean"},"blocked":{"type":"boolean"},"indexTerminologyOrDefault":{"$ref":"#/components/schemas/IndexTerminology"},"paused":{"type":"boolean"}}},"EngagementActionTimeConfig":{"type":"object","properties":{"hour":{"type":"integer","format":"int32"},"minute":{"type":"integer","format":"int32"}}},"CompanyAccountStatus":{"type":"string","description":"Status of a company account (active, blocked, paused)","enum":["ACTIVE","BLOCKED","PAUSED"]},"CompanyConfigAssets":{"type":"object","properties":{"productName":{"type":"string"},"productMailLogo":{"type":"string"},"productIosStoreURL":{"type":"string"},"productIpadosStoreURL":{"type":"string"},"productAndroidStoreURL":{"type":"string"},"productSlackInstallURL":{"type":"string"},"productMSTeamsInstallURL":{"type":"string"},"productWebClientURL":{"type":"string"},"productAppsURL":{"type":"string"},"unsubEmailURL":{"type":"string"},"notificationsApplicationId":{"type":"string"}},"required":["productAndroidStoreURL","productAppsURL","productIosStoreURL","productIpadosStoreURL","productMSTeamsInstallURL","productMailLogo","productName","productSlackInstallURL","productWebClientURL","unsubEmailURL"]},"IndexTerminology":{"type":"string","description":"Vocabulary a company uses for its engagement index. HAPPINESS keeps the historical \"Happiness Index\" wording (default for existing companies); WELLBEING shows the \"Wellbeing Index\" wording. Presentation only — it does not change how the index is computed.","enum":["HAPPINESS","WELLBEING"]},"AfterVoteMessagesConfig":{"type":"object","description":"Per-company custom texts for the after-vote celebration cards (birthday and work anniversary). Each field is a MultiLanguage value; any field left null (or a language missing from a MultiLanguage) falls back to the default i18n text. Bodies may include the '*|COMPANY|*' placeholder, replaced with the company name at render time.","properties":{"birthdayTitle":{"$ref":"#/components/schemas/MultiLanguage","description":"Custom title for the birthday after-vote card. Null falls back to the default i18n title."},"birthdayBody":{"$ref":"#/components/schemas/MultiLanguage","description":"Custom body for the birthday after-vote card. May contain the '*|COMPANY|*' placeholder. Null falls back to the default i18n body."},"workAnniversaryTitle":{"$ref":"#/components/schemas/MultiLanguage","description":"Custom title for the work anniversary after-vote card. Null falls back to the default i18n title."},"workAnniversaryBody":{"$ref":"#/components/schemas/MultiLanguage","description":"Custom body for the work anniversary after-vote card. May contain the '*|COMPANY|*' placeholder. Null falls back to the default i18n body."}}},"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"]},"ConversationsDisplayMoment":{"type":"string","enum":["BEFORE_VOTE","AFTER_VOTE"]}}},"paths":{"/api/v1/company/config/{companyId}":{"post":{"tags":["company-config-resource"],"operationId":"updateCompanyConfig","parameters":[{"name":"companyId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/CompanyConfig"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/CompanyConfig"}}}}}}}}}
```

## POST /api/v1/company/config/{companyId}/{accountStatus}

>

```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":[{"companyAPISessionId":[]}],"components":{"securitySchemes":{"companyAPISessionId":{"type":"apiKey","description":"SessionId","name":"SessionId","in":"header"}},"schemas":{"CompanyAccountStatus":{"type":"string","description":"Status of a company account (active, blocked, paused)","enum":["ACTIVE","BLOCKED","PAUSED"]},"CompanyConfig":{"type":"object","properties":{"alertDays":{"type":"array","items":{"type":"integer","format":"int32"}},"alertHour":{"type":"integer","format":"int32"},"alertMinute":{"type":"integer","format":"int32"},"voteReminderDays":{"type":"array","items":{"type":"integer","format":"int32"}},"voteReminderTimeConfig":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/EngagementActionTimeConfig"}},"inappropiateThreshold":{"type":"integer","format":"int32"},"hiCalculationMode":{"type":"string","enum":["CLASSIC","POSITIVENESS","AVERAGES"]},"elapsedDaysSinceLastVote":{"type":"integer","format":"int32"},"minActiveEmployees":{"type":"integer","format":"int32"},"apiKey":{"type":"string"},"validDomains":{"type":"array","items":{"type":"string"},"uniqueItems":true},"domainPatternExclusions":{"type":"array","items":{"type":"string"},"uniqueItems":true},"renameManagerComentsHierarchy":{"type":"boolean"},"defaultLanguage":{"type":"string"},"supportedLanguages":{"type":"array","items":{"type":"string"},"uniqueItems":true},"sentimentalAnalyticsEnabled":{"type":"boolean"},"personalityAnalyticsEnabled":{"type":"boolean"},"timezone":{"type":"string"},"status":{"$ref":"#/components/schemas/CompanyAccountStatus"},"launchStatus":{"type":"string","enum":["CREATED","PRELAUNCH","LAUNCHED","CRUISE_SPEED"]},"source":{"type":"string","enum":["SELF_SERVICE","SALE","PARTNER_SALE"]},"plan":{"type":"string","enum":["TEST","TRIAL","SUBSCRIPTION"]},"blockReason":{"type":"string"},"blockedDate":{"type":"string","format":"date-time"},"blockerId":{"type":"string"},"startDate":{"type":"string","format":"date-time"},"resetProfileMode":{"type":"string","enum":["NEVER","EACH_30_DAYS","ALWAYS"]},"expireActivationCodes":{"type":"boolean"},"disabledEgagementNonActivatedMails":{"type":"boolean"},"disabledEmailManagersRanking":{"type":"boolean"},"monthlyReportOnlyForAdmins":{"type":"boolean","deprecated":true},"rolesForMonthlyReport":{"type":"array","items":{"type":"string","enum":["ADVISOR","ADMIN","RESPONSIBLE","PUBLIC","MANAGER","EMPLOYEE"]},"uniqueItems":true},"disableEngagementMails":{"type":"boolean"},"assetsOverrides":{"$ref":"#/components/schemas/CompanyConfigAssets"},"includeInBenchmark":{"type":"boolean"},"industryType":{"type":"string","enum":["ACCOMMODATION_AND_FOOT_SERVICES","ARTS_ENTERTAINMENT_RECREATION","COMPUTER_SOFTWARE_IT_SERVICES","CONSTRUCTION","EDUCATIONAL_SERVICES","FINANCIAL_SERVICES_INSURANCE","HEALTH_CARE_SOCIAL_ASSISTANCE","MANAGEMENT_CONSULTING","MANUFACTURING","MARKETING_ADVERTISING","NATURAL_RESOURCES","NON_PROFIT_ORGANIZATION","PROFESSIONAL_SCIENTIFIC_AND_TECHNICAL_SERVICES","PUBLIC_AND_GOVERMENT_ADMINISTRATION","REAL_ESTATE_RENTAL_AND_LEASING","TRANSPORTATION_AND_WAREHOUSING","UTILITIES_AND_SERVICES","WHOLESALE_AND_RETAIL_TRADE","OTHER"]},"jobEnvironment":{"type":"string","enum":["OFFICE","NON_DESKTOP","GEEK"]},"requireVoteToSeeResults":{"type":"boolean"},"overrideDepartmentWithCompanyName":{"type":"boolean"},"mailVoteFrequency":{"type":"string","enum":["DISABLED","EACH_WEEK","EACH_TWO_WEEKS"]},"overrideVoteImageWithFeedbackType":{"type":"boolean"},"appStyle":{"type":"string"},"enableClassificationFollowups":{"type":"boolean"},"enableAutoInvite":{"type":"boolean"},"autoInviteToken":{"type":"string"},"statsTransparencyMode":{"type":"string","enum":["MANAGERS","ALL"]},"announcementNotificationDays":{"type":"array","items":{"type":"integer","format":"int32"}},"announcementNotificationStartHour":{"type":"integer","format":"int32"},"announcementNotificationEndHour":{"type":"integer","format":"int32"},"questionNotificationDays":{"type":"array","items":{"type":"integer","format":"int32"}},"questionNotificationStartHour":{"type":"integer","format":"int32"},"questionNotificationEndHour":{"type":"integer","format":"int32"},"surveyNotificationDays":{"type":"array","items":{"type":"integer","format":"int32"}},"surveyNotificationStartHour":{"type":"integer","format":"int32"},"surveyNotificationEndHour":{"type":"integer","format":"int32"},"fakeEmployeeStats":{"type":"boolean"},"allowBlockUsers":{"type":"boolean"},"moodNotesOnHiEnabled":{"type":"boolean"},"timeRegistrationEnabled":{"type":"boolean"},"heroRequiredRole":{"type":"string","enum":["ADVISOR","ADMIN","RESPONSIBLE","PUBLIC","MANAGER","EMPLOYEE"]},"loginByAccessLinkOnly":{"type":"boolean","deprecated":true},"allowedLoginMethods":{"type":"array","items":{"type":"string","enum":["USER_PASSWORD","USER_ACCESS_LINK","GOOGLE_AUTH","MICROSOFT_AUTH","HP_AUTH","SSO_SAML2","SSO_OIDC"]},"uniqueItems":true},"votingFlow":{"type":"string","enum":["QUESTIONS","ANNOUNCEMENTS"]},"context":{"type":"string","deprecated":true},"lifeEventsReminderEnabled":{"type":"boolean"},"birthdayDayOffEnabled":{"type":"boolean"},"employeeHierarchyConfiguredByAdmins":{"type":"boolean"},"rataModeEnabled":{"type":"boolean"},"enableManagerMonthlyReport":{"type":"boolean"},"enableManagerAiMonthlyEmail":{"type":"boolean"},"enableManagerOverview":{"type":"boolean"},"enableAccountDiagnostician":{"type":"boolean"},"actionsEnabled":{"type":"boolean"},"rewardsEnabled":{"type":"boolean"},"enableActionCoordinator":{"type":"boolean"},"indexTerminology":{"$ref":"#/components/schemas/IndexTerminology","description":"Vocabulary the company uses for its engagement index. Null defaults to HAPPINESS so existing companies keep the historical wording."},"afterVoteMessages":{"$ref":"#/components/schemas/AfterVoteMessagesConfig","description":"Per-company custom texts for the after-vote celebration cards (birthday / work anniversary). Null means the company uses the default i18n texts."},"afterVoteQuoteMinProbability":{"type":"integer","format":"int32","description":"Minimum chance (0-100) of showing the after-vote fortune cookie. Acts as a floor over the adaptive chance; 100 means every day. Null means the adaptive chance only.","maximum":100,"minimum":0},"conversationsOnLoginEnabled":{"type":"boolean"},"conversationsDisplayMoment":{"$ref":"#/components/schemas/ConversationsDisplayMoment"},"managementFocusActivatedAt":{"type":"string","format":"date-time"},"managementFocusDraftConfirmedAt":{"type":"string","format":"date-time"},"managementFocusDraftConfirmedBy":{"type":"string"},"hfmeEnabled":{"type":"boolean"},"hfheroEnabled":{"type":"boolean"},"active":{"type":"boolean"},"blocked":{"type":"boolean"},"indexTerminologyOrDefault":{"$ref":"#/components/schemas/IndexTerminology"},"paused":{"type":"boolean"}}},"EngagementActionTimeConfig":{"type":"object","properties":{"hour":{"type":"integer","format":"int32"},"minute":{"type":"integer","format":"int32"}}},"CompanyConfigAssets":{"type":"object","properties":{"productName":{"type":"string"},"productMailLogo":{"type":"string"},"productIosStoreURL":{"type":"string"},"productIpadosStoreURL":{"type":"string"},"productAndroidStoreURL":{"type":"string"},"productSlackInstallURL":{"type":"string"},"productMSTeamsInstallURL":{"type":"string"},"productWebClientURL":{"type":"string"},"productAppsURL":{"type":"string"},"unsubEmailURL":{"type":"string"},"notificationsApplicationId":{"type":"string"}},"required":["productAndroidStoreURL","productAppsURL","productIosStoreURL","productIpadosStoreURL","productMSTeamsInstallURL","productMailLogo","productName","productSlackInstallURL","productWebClientURL","unsubEmailURL"]},"IndexTerminology":{"type":"string","description":"Vocabulary a company uses for its engagement index. HAPPINESS keeps the historical \"Happiness Index\" wording (default for existing companies); WELLBEING shows the \"Wellbeing Index\" wording. Presentation only — it does not change how the index is computed.","enum":["HAPPINESS","WELLBEING"]},"AfterVoteMessagesConfig":{"type":"object","description":"Per-company custom texts for the after-vote celebration cards (birthday and work anniversary). Each field is a MultiLanguage value; any field left null (or a language missing from a MultiLanguage) falls back to the default i18n text. Bodies may include the '*|COMPANY|*' placeholder, replaced with the company name at render time.","properties":{"birthdayTitle":{"$ref":"#/components/schemas/MultiLanguage","description":"Custom title for the birthday after-vote card. Null falls back to the default i18n title."},"birthdayBody":{"$ref":"#/components/schemas/MultiLanguage","description":"Custom body for the birthday after-vote card. May contain the '*|COMPANY|*' placeholder. Null falls back to the default i18n body."},"workAnniversaryTitle":{"$ref":"#/components/schemas/MultiLanguage","description":"Custom title for the work anniversary after-vote card. Null falls back to the default i18n title."},"workAnniversaryBody":{"$ref":"#/components/schemas/MultiLanguage","description":"Custom body for the work anniversary after-vote card. May contain the '*|COMPANY|*' placeholder. Null falls back to the default i18n body."}}},"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"]},"ConversationsDisplayMoment":{"type":"string","enum":["BEFORE_VOTE","AFTER_VOTE"]}}},"paths":{"/api/v1/company/config/{companyId}/{accountStatus}":{"post":{"tags":["company-config-resource"],"operationId":"updateCompanyAccountStatus","parameters":[{"name":"companyId","in":"path","required":true,"schema":{"type":"string"}},{"name":"accountStatus","in":"path","required":true,"schema":{"$ref":"#/components/schemas/CompanyAccountStatus"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/CompanyConfig"}}}}}}}}}
```

## POST /api/v1/company/config/setup

>

```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":[{"companyAPISessionId":[]}],"components":{"securitySchemes":{"companyAPISessionId":{"type":"apiKey","description":"SessionId","name":"SessionId","in":"header"}},"schemas":{"CompanySetupRequestDTO":{"type":"object","properties":{"industryType":{"type":"string","enum":["ACCOMMODATION_AND_FOOT_SERVICES","ARTS_ENTERTAINMENT_RECREATION","COMPUTER_SOFTWARE_IT_SERVICES","CONSTRUCTION","EDUCATIONAL_SERVICES","FINANCIAL_SERVICES_INSURANCE","HEALTH_CARE_SOCIAL_ASSISTANCE","MANAGEMENT_CONSULTING","MANUFACTURING","MARKETING_ADVERTISING","NATURAL_RESOURCES","NON_PROFIT_ORGANIZATION","PROFESSIONAL_SCIENTIFIC_AND_TECHNICAL_SERVICES","PUBLIC_AND_GOVERMENT_ADMINISTRATION","REAL_ESTATE_RENTAL_AND_LEASING","TRANSPORTATION_AND_WAREHOUSING","UTILITIES_AND_SERVICES","WHOLESALE_AND_RETAIL_TRADE","OTHER"]},"feedbackLevelMode":{"$ref":"#/components/schemas/FeedbackLevelMode"},"companyName":{"type":"string"},"defaultLanguage":{"type":"string"},"timezone":{"type":"string"},"domains":{"type":"array","items":{"type":"string"},"uniqueItems":true}}},"FeedbackLevelMode":{"type":"string","enum":["ANONYMOUS_OPEN","ANONYMOUS_ON_REPLY","ALL_CLOSED","NO_FEEDBACK"]},"CompanyDTO":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"mainEmail":{"type":"string"},"mainAddress":{"type":"string"},"mainPhone":{"type":"string"},"imageUrl":{"type":"string"},"createdOn":{"type":"string","format":"date-time"},"status":{"$ref":"#/components/schemas/CompanyAccountStatus"},"launchStatus":{"type":"string","enum":["CREATED","PRELAUNCH","LAUNCHED","CRUISE_SPEED"]}}},"CompanyAccountStatus":{"type":"string","description":"Status of a company account (active, blocked, paused)","enum":["ACTIVE","BLOCKED","PAUSED"]}}},"paths":{"/api/v1/company/config/setup":{"post":{"tags":["company-config-resource"],"operationId":"setupCompany","requestBody":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/CompanySetupRequestDTO"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/CompanyDTO"}}}}}}}}}
```

## POST /api/v1/company/config/image

>

```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":[{"companyAPISessionId":[]}],"components":{"securitySchemes":{"companyAPISessionId":{"type":"apiKey","description":"SessionId","name":"SessionId","in":"header"}},"schemas":{"CompanyDTO":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"mainEmail":{"type":"string"},"mainAddress":{"type":"string"},"mainPhone":{"type":"string"},"imageUrl":{"type":"string"},"createdOn":{"type":"string","format":"date-time"},"status":{"$ref":"#/components/schemas/CompanyAccountStatus"},"launchStatus":{"type":"string","enum":["CREATED","PRELAUNCH","LAUNCHED","CRUISE_SPEED"]}}},"CompanyAccountStatus":{"type":"string","description":"Status of a company account (active, blocked, paused)","enum":["ACTIVE","BLOCKED","PAUSED"]}}},"paths":{"/api/v1/company/config/image":{"post":{"tags":["company-config-resource"],"operationId":"uploadCompanyImage","requestBody":{"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"file":{"type":"string","format":"binary"}},"required":["file"]}},"*/*":{"schema":{"type":"object","properties":{"file":{"type":"string","format":"binary"}},"required":["file"]}}}},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/CompanyDTO"}}}}}}}}}
```

## GET /api/v1/company/config/customization

>

```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":[{"companyAPISessionId":[]}],"components":{"securitySchemes":{"companyAPISessionId":{"type":"apiKey","description":"SessionId","name":"SessionId","in":"header"}},"schemas":{"CompanyCustomizationDTO":{"type":"object","properties":{"employeeInvitation":{"$ref":"#/components/schemas/MultiLanguage"}}},"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"]}}},"paths":{"/api/v1/company/config/customization":{"get":{"tags":["company-config-resource"],"operationId":"getCompanyCustomization","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/CompanyCustomizationDTO"}}}}}}}}}
```

## POST /api/v1/company/config/customization

>

```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":[{"companyAPISessionId":[]}],"components":{"securitySchemes":{"companyAPISessionId":{"type":"apiKey","description":"SessionId","name":"SessionId","in":"header"}},"schemas":{"CompanyCustomizationDTO":{"type":"object","properties":{"employeeInvitation":{"$ref":"#/components/schemas/MultiLanguage"}}},"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"]}}},"paths":{"/api/v1/company/config/customization":{"post":{"tags":["company-config-resource"],"operationId":"updateCompanyCustomization","requestBody":{"content":{"*/*":{"schema":{"$ref":"#/components/schemas/CompanyCustomizationDTO"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/CompanyCustomizationDTO"}}}}}}}}}
```

## GET /api/v1/company/config/status

>

```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":[{"companyAPISessionId":[]}],"components":{"securitySchemes":{"companyAPISessionId":{"type":"apiKey","description":"SessionId","name":"SessionId","in":"header"}}},"paths":{"/api/v1/company/config/status":{"get":{"tags":["company-config-resource"],"operationId":"getCompanyConfigStatus","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"type":"string","enum":["NO_EMPLOYEES","NO_ENOUGH_ACTIVE_EMPLOYEES","NO_ENOUGH_ACTIVE_EMPLOYEES_PRELAUNCH","NO_ALL_EMPLOYEES_HAVE_NAMES","HIERARCHIES_NO_MINIMUM","NO_ANNOUNCEMENTS_PRELAUNCH","NO_HIERARCHIES_PRELAUNCH"]}}}}}},"deprecated":true}}}}
```

## GET /api/v1/company/config/domain/{domain}

>

```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":[{"companyAPISessionId":[]}],"components":{"securitySchemes":{"companyAPISessionId":{"type":"apiKey","description":"SessionId","name":"SessionId","in":"header"}},"schemas":{"CheckDomainResponse":{"type":"object","properties":{"domain":{"type":"string"},"status":{"type":"string","enum":["VALID","RESTRICTED","INVALID","IN_USE"]}}}}},"paths":{"/api/v1/company/config/domain/{domain}":{"get":{"tags":["company-config-resource"],"operationId":"checkDomain","parameters":[{"name":"domain","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/CheckDomainResponse"}}}}}}}}}
```
