Replace SCIM Role Mappings
Replace the organisation's full group-to-role mapping table.
Authorization: caller must be the owner.
Existing SCIM users' roles are not recomputed automatically - call POST /{org_id}/scim/sync afterwards to apply the new mapping (mirrors the "Sync" action in the settings UI).
Authorization
OAuth2AuthorizationCodeBearer AuthorizationBearer <token>
In: header
Path Parameters
org_id*Org Id
Format
uuidQuery Parameters
verify_locally?Verify Locally
Default
trueRequest Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
curl -X PUT "https://example.com/v1/organisations/497f6eca-6276-4993-bfeb-53cbbbba6f08/scim/role-mappings" \ -H "Content-Type: application/json" \ -d '{ "mappings": [ { "group_display_name": "string", "role": "string" } ] }'[ { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "group_display_name": "string", "role": "string" }]{ "detail": [ { "loc": [ "string" ], "msg": "string", "type": "string" } ]}