Group mapping

Update a group mapping

Updates a group mapping. role_ids REPLACES the mapped role when present — at most one role, since a member holds exactly one (two or more answers 400 role_cardinality). Members lose the old mapped role on their next recompute; manually assigned roles are untouched and always win. Requires sso:manage, and — because a mapping is a deferred grant applied with no actor present — you may only map a role whose permissions you hold yourself. A browser session must also pass a fresh step-up reauthentication in the app (without it the call answers 428 step_up_required). An organization API token is not challenged.

patch/group-mapping/{id}

Request

  • Base URL: https://api.elaichi.ai
  • URL: https://api.elaichi.ai/group-mapping/{id}
  • Auth: HTTP bearer

Path parameters

idstring required

Group mapping id (gmap_…).

Headers

X-Organization-Idstring

Target organization (org_…). Required for cookie/session auth on org-scoped routes; optional for API tokens, which carry their organization, and rejected when it names a different one.

Request body

scim_group_idstring
role_idsstring[]

Replaces the mapped role; at most one.

Response

OK

idstring

Group mapping id (gmap_…).

scim_group_idstring

SCIM group from GET /scim-group.

role_idsstring[]

The single role (role_…) every member of that group receives.

created_atstring date-time
updated_atstring date-time

Changes

No recorded changes to this operation across all 1 revision of this API.