feat(api): sync Industry enum with IndustryV2 source#26
Merged
Conversation
Replace the inline 30-value enum on CompanyOwnerRequest/Response with a shared `Industry` component schema mirroring `IndustryV2` from development-utils (86 values). Update the example payload from the now- removed `INFORMATION_TECHNOLOGY` to `SOFTWARE_DEVELOPMENT`.
|
Preview deployment for your docs. Learn more about Mintlify Previews.
💡 Tip: Enable Workflows to automatically generate PRs for you. |
leonisandes
approved these changes
May 11, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Description
Replace the inline
industryenum onCompanyOwnerRequest/CompanyOwnerResponsewith a sharedIndustrycomponent schema mirroringIndustryV2fromdevelopment-utils(the live source of truth, 86 values). The previous published enum (30 values) had drifted: most of its entries (e.g.INFORMATION_TECHNOLOGY,RETAIL_SALES__RETAIL_TRADE,MEDIA__ENTERTAINMENT) are not part ofIndustryV2and would be rejected by the backend.Per the OpenAPI authoring rules in
.claude/rules/openapi.md, any value used in two or more places is extracted tocomponents.schemas— so the sameIndustryschema now backs both request and response.The schema is intentionally named
Industry, notIndustryV2: public docs avoid versioned internal class names, and there is no otherIndustryschema published here to disambiguate against.Key Changes
apis/fx-account/openapi.yml:Industrycomponent schema with all 86 values fromIndustryV2.kt, preserving the source orderCompanyOwnerRequest.industry: inline 30-value enum →$ref: "#/components/schemas/Industry"CompanyOwnerResponse.industry: inlinetype: string→$ref: "#/components/schemas/Industry"industry: "INFORMATION_TECHNOLOGY"→industry: "SOFTWARE_DEVELOPMENT"(the old value is no longer in the enum)Type of change
The published enum was wrong — every value an integrator picked from the old list (except
ENERGY,TRANSPORTATION,OTHERS) would 422 against the live API. Switching to the IndustryV2 list is a contract correction for the wire, but a breaking change for anyone who had wired against the doc.How Has This Been Tested?
mint validatepasses locally.Checklist: