POST /api/org/admin/groups/{id}/members {memberId} — add a member. 409 GROUP_EXTERNALLY_MANAGED if the group's source isn't "kiban" (the single-writer invariant).
POST /api/org/admin/positions/{id}/assignments {memberId} — assign-NOW (server-dated). 409 POSITION_HELD, with the current assignmentId and memberId in details, while someone holds the position: end that assignment first.
POST /api/org/admin/companies/{companyId}/groups {code,name} — companyId comes from the PATH only; the group is always created with source="kiban" (the only source this surface can create).
POST /api/org/admin/companies/{companyId}/positions {code,title,orgUnitId?} — companyId comes from the PATH only; orgUnitId must sit under the company and defaults to its root.
POST /api/org/admin/assignments/{id}/end — end-NOW, no body (server-dated). 409 ASSIGNMENT_ALREADY_ENDED when the assignment's window is already closed.
POST /api/org/admin/positions/{id}/handover {memberId, expectedAssignmentId?} — end the current assignment and assign memberId in one transaction; idempotent when memberId already holds it. 409 POSITION_HELD when expectedAssignmentId is no longer current; 422 when the position is empty (assign instead).
GET /api/org/admin/groups/{id}/members — the Groups admin page's own member-list read, needed to render a remove button per current member (add/remove alone can't drive a UI without knowing WHO to remove).
GET /api/org/admin/companies/{companyId}/groups — list, each row carrying its member count and source (externally-sourced groups render read-only with a source badge).
Optionalpage: numberOptionalpageSize: numberGET /api/org/admin/companies/{companyId}/positions — list, each row carrying its CURRENT assignment (assignmentId/memberId/holderDisplayName — null when unassigned).
Optionalpage: numberOptionalpageSize: numberDELETE /api/org/admin/groups/{id}/members/{memberId} — remove a member. Same 409 GROUP_EXTERNALLY_MANAGED refusal as adminAddGroupMember.
PUT /api/org/admin/positions/{id} {title?,orgUnitId?} — retitle, or move the position to another org unit of its company; an absent field keeps its value.
GET /api/org/companies/{companyId}/groups — the company's active groups (id, code, name).
Optionalpage: numberOptionalpageSize: numberGET /api/org/me/companies — companies where the CALLER (kcSub-injected by the gateway) has an active membership in an active company; the company-switcher source.
GET /api/org/companies/{companyId}/members — the gateway-exposed, least-disclosure member picker (share-with/assign-to). q is an optional case-insensitive substring filter over displayName/email.
Optionalq: stringOptionalpage: numberOptionalpageSize: numberGET /api/org/companies/{companyId}/positions — the company's positions (id, code, title) for
any active member; the share-with or assign-to picker beside memberDirectory.
Optionalpage: numberOptionalpageSize: number
Typed client over org's gateway-exposed HTTP surface:
meCompanies,memberDirectory, and the superadmin-onlyadmin*position/group methods.