Skip to content

docs(V2): document optional fields for unit split endpoint#1574

Merged
TheLastCicada merged 3 commits into
v2-rc2from
docs/v2-unit-split-fields
Apr 7, 2026
Merged

docs(V2): document optional fields for unit split endpoint#1574
TheLastCicada merged 3 commits into
v2-rc2from
docs/v2-unit-split-fields

Conversation

@TheLastCicada

@TheLastCicada TheLastCicada commented Apr 7, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Fix incorrect field names in the v2/unit/split documentation example (unitOwnerunitCurrentOwner, removed non-existent countryJurisdictionOfOwner)
  • Add field reference tables documenting the required (unitCount) and optional (unitBlockStart, unitBlockEnd, unitCurrentOwner, unitStatus, unitStatusReason, unitStatusDate) fields per split record
  • Add uuid to the response example to match actual controller behavior

Test plan

  • Verify rendered markdown tables display correctly on GitHub
  • Confirm field names match the UnitV2.split() implementation in src/models/v2/unit-v2.model.js

Note

Low Risk
Low risk: documentation-only changes that correct field names and examples, with no runtime or data-handling impact.

Overview
Improves the POST /v2/unit/split documentation by explaining split behavior (inherit/override semantics and ID assignment) and adding required/optional per-record field tables.

Fixes the request example to use unitCurrentOwner (and removes non-existent fields) and updates the response example to include the returned uuid.

Reviewed by Cursor Bugbot for commit 27c46fd. Bugbot is set up for automated code reviews on this repo. Configure here.

TheLastCicada and others added 3 commits March 31, 2026 13:07
The v2/unit/split example used incorrect v1 field names (unitOwner,
countryJurisdictionOfOwner) and was missing supported optional fields.
Add field reference tables and fix the example to use the correct v2
field names: unitCurrentOwner, unitStatusReason, unitStatusDate.
@TheLastCicada TheLastCicada changed the base branch from develop to v2-rc2 April 7, 2026 20:09
@TheLastCicada TheLastCicada merged commit 24b5eec into v2-rc2 Apr 7, 2026
25 checks passed
@TheLastCicada TheLastCicada deleted the docs/v2-unit-split-fields branch April 7, 2026 20:55
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant