Groundeddocs
ReferenceAdmin

Change a rule's group or role (platform admins with a session; audited)

PATCH/v1/admin/group-mapping/rules/{ruleId}

Applied at once, like a new rule; the rule's team never changes (add a rule for another team instead). Audited as platform.sso_rule_update.

Path Parameters

ruleId*string
Formatuuid

Header Parameters

If-Match*string

The resource's revision, as returned in ETag (for example "3"). Missing returns 428; stale returns 412.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X PATCH "https://example.com/v1/admin/group-mapping/rules/497f6eca-6276-4993-bfeb-53cbbbba6f08" \  -H "If-Match: string" \  -H "Content-Type: application/json" \  -d '{}'
{  "data": {    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",    "group": "registrar-staff",    "team": {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "slug": "string",      "name": "string"    },    "teamStatus": "active",    "role": "owner",    "memberCount": 0,    "revision": 0,    "createdAt": "2019-08-24T14:15:22Z",    "updatedAt": "2019-08-24T14:15:22Z"  }}